home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 July / EnigmA AMIGA RUN 29 (1998)(G.R. Edizioni)(IT)[!][issue 1998-07 & 08].iso / earkit / mail / aemail143 / files.lha / AEMail.doc < prev    next >
Text File  |  1998-01-15  |  327KB  |  7,119 lines
  1.  
  2.                                 AEMAIL.DOC
  3.  
  4.  
  5. Name of Program: AEMail (Amiga E-Mail)
  6.  
  7. Version: 1.43 (BETA)
  8. Release Date: January 15, 1998
  9.  
  10. Written By: John F. Zacharias
  11.  
  12. AEMail is copyright (c) 1996-98 by John F.  Zacharias, all rights
  13. reserved.  Permission is given to Beta Testers to test and evaluate the
  14. program in return for feedback on the use of the program and reporting of
  15. any bugs encountered.
  16.  
  17.      AEMAIL SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  18.      NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  19.      OR RESPONSIBILITY IS ASSUMED.
  20.  
  21. Installer and Installer project icon (c) Copyright 1995-96 Escom AG.  All
  22. Rights Reserved.  Reproduced and distributed under license from Escom AG.
  23.  
  24. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  25. NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  26. OR RESPONSIBILITY IS ASSUMED.
  27.  
  28. This documentation is divided into the following Sections and sub-topics:
  29.  
  30.     I. PROGRAM PURPOSE
  31.  
  32.     II. SYSTEM REQUIREMENTS
  33.  
  34.         REQUIREMENTS
  35.         RESTRICTIONS
  36.         REGISTRATION
  37.  
  38.     III. INSTALLATION
  39.  
  40.     IV. CONFIGURATION
  41.  
  42.         TOOL TYPES
  43.             INTERLACE=YES
  44.             MAIL_DIR=directory-path
  45.             CONFIG=configuration-file
  46.             MAILCAP_DIR=directory-path
  47.             USERID=UserId
  48.             PASSWRD=your_password
  49.             PASSPROTECT=YES             (registered users only)
  50.             DOMAIN=Domain_Name
  51.             FROM=your_email_address
  52.             REALNAME=your_real_name
  53.             REPLYTO=reply-email-address
  54.             ORGANIZATION=organization-name
  55.             POP_SERVER=your_POP_host
  56.             SMTP_SERVER=your_SMTP_host
  57.             EDITOR=call_line_for_your_editor
  58.             TCPLOG=name_of_log_file
  59.             DELETEMAIL=YES
  60.             FULLHEADER=YES
  61.             STRIPDUPS=YES
  62.             HDRINREPLY=YES
  63.             STARTNET=call_line_for_your_startnet_script
  64.             STOPNET=call_line_for_your_stopnet_script
  65.             AUTOCONNECT=YES
  66.             FLDRFONT=fontname
  67.             FLDRFONTSZ=fontsize
  68.  
  69.         CONFIGURATION SCREEN
  70.             Identity Page
  71.             TCP/IP Page
  72.             Default Path Page
  73.             Other Parameters Page
  74.  
  75.     V. USING AEMAIL
  76.  
  77.         Starting AEMail
  78.             Starting AEMail from the Shell
  79.             Activating AEMail from the Workbench
  80.         Using AEMail as a "MailTo" Agent
  81.         Editing String Entry Gadgets
  82.         Using the Clipboard with AEMail
  83.         Filtering Messages with AEMail
  84.  
  85.     VI. COMMAND ICON TOOL BAR
  86.  
  87.         Display Folder List
  88.         Display Address Book
  89.         Retrieve Messages
  90.         Display Previous Message
  91.         Display Previous Folder's Message List
  92.         Display Current Folder's Message List
  93.         Display Next Folder's Message List
  94.         Display Next Message
  95.         Compose A Message
  96.         Queue Message For Later Delivery
  97.         Send Message Immediately
  98.         Save Message To File
  99.         Print
  100.         Delete/Undelete Message
  101.         Copy Messages to a New Folder
  102.         Transfer Messages to a New Folder
  103.         Start TCP/IP Network Connection
  104.         Terminate TCP/IP Network Connection
  105.  
  106.     VII. AEMAIL MENUS
  107.  
  108.         Project menu
  109.             Configuration...
  110.                 Open...
  111.                 Edit...
  112.                 Save
  113.                 Save As...
  114.                 Restore Default
  115.             Send Queued Mail
  116.             Iconify AEMail
  117.             About...
  118.             Quit...
  119.  
  120.         Folders menu
  121.             New...
  122.             Edit...
  123.             Delete...
  124.             Set Sort Key...
  125.             Remove DELETED Msgs
  126.  
  127.         Messages menu
  128.             Show
  129.                 Deleted Messages
  130.                 UnRead Msgs Only
  131.             Compose...
  132.             Reply
  133.                 Use Reply-To...
  134.                 Use From...
  135.             Forward...
  136.             Edit...
  137.             Select None
  138.             Select All
  139.             Last Selected
  140.             Export...
  141.             Copy...
  142.             Transfer...
  143.             Print
  144.             Delete/Undelete...
  145.             Display Full Hdr
  146.             Incl Hdr in Resp
  147.  
  148.         Retrieve Msgs menu
  149.             From POP Host
  150.             From Local File...
  151.             Excl Dup Msgs
  152.             Delete Host Mail
  153.  
  154.         TCP/IP menu
  155.  
  156.             Start Net
  157.             Stop Net
  158.             TCP Logging File
  159.                 Active
  160.                 Purge
  161.                 Display/Edit...
  162.  
  163.     VIII. AEMAIL WINDOWS
  164.  
  165.         Configuration Screen
  166.         Folder List Window
  167.         Message List Window
  168.         Folder Configuration Window
  169.         Filter Selection Window
  170.             Examples of using Message Filtering
  171.         Set Sort Keys Window
  172.             Examples of Setting Sort Keys
  173.         Address Book Window
  174.         Message Display Window
  175.             Attachment Requester
  176.         Compose Message Window
  177.             Add Attachments Requester
  178.  
  179.     IX. AEMAIL FILES
  180.  
  181.         mailcap
  182.         configuration (s:aemail.cnfg)
  183.         folder.config
  184.         [folder_Name].config
  185.         .addrbook
  186.         .signature
  187.         Messages
  188.         TCP Trace Log File (TCPLOG)
  189.  
  190.     X. BUG REPORTS & SUGGESTIONS
  191.  
  192.     XI. ACKNOWLEDGEMENTS
  193.  
  194.     XII. IN CONCLUSION
  195.  
  196.  
  197.                            I. PROGRAM PURPOSE
  198.  
  199. AEMail is a mail client designed to read, process, compose and send e-mail
  200. from an Amiga computer over the Internet.  It provides an easy to use
  201. graphical interface designed specifically for the Amiga.  It connects to
  202. an Internet server through AmiTCP or any TCP/IP stack compatable with
  203. AmiTCP.  This includes TermiteTCP and Miami.  It uses the AmigaDOS editor,
  204. ed, or any other editor of the user's choosing for developing email
  205. messages.  No other external programs or modules are required.  The POP3
  206. and SMTP protocols are built into the program.
  207.  
  208. The current version of AEMail supports attachments following the MIME
  209. (Multipurpose Internet Mail Extension) outline in RFC 1341, 1521, 1524
  210. (Mailcap files), and 1806 as well as UUENCODED attached files.  Not all of
  211. the features of MIME headers are fully supported and exceptions will be
  212. noted in the documentation.
  213.  
  214. AEMail can also be used as a "MailTo" agent in WWW browsers, such as
  215. IBrowse, Voyager and AWeb, which allow the user to specify such an agent
  216. for composing and sending email.
  217.  
  218. You can also call AEMail from another program to send a message created by
  219. that program.
  220.  
  221.  
  222. II. SYSTEM REQUIREMENTS:
  223.  
  224.                                REQUIREMENTS
  225.  
  226. This program can run on any Amiga Operating Systen 2.1 and above.
  227.  
  228. This program requires a TCP/IP stack compatable with AmiTCP.  It has been
  229. tested with the 4.0 Demo Version of AmiTCP, but will possibly run on
  230. earlier versions at level 2.0 or greater.  It also has been tested under
  231. TermiteTCP and Miami which use a TCP/IP stack that is compatable with
  232. AmiTCP.
  233.  
  234. Other TCP/IP software may or may not be compatable with AmiTCP.  If the
  235. software uses a socket library (bsdsocket.library) with calls that are
  236. compatable with AmiTCP, it possibly will work.
  237.  
  238. If you wish to display MIME attachments from within AEMail, you will also
  239. need a 'Mailcap' file.  Specifications for how to set up a mailcap file
  240. are given under the IX.  AEMAIL FILES section below.  It is possible to
  241. display attachments with either AmigaDos 2.x or 3.x.  Datatypes are not
  242. required for this display.
  243.  
  244. A sample mailcap file is also provided in the archive.  This sample
  245. mailcap file can be used without modification on any system running under
  246. AmigaDos 3.0 or later since it uses multiview as the display agent.  If
  247. you are using a version of AmigaDos before 3.0, you will have to modify
  248. the mailcap file to specify your own favorite display program for specific
  249. "Content Type/Subtypes".
  250.  
  251.                                RESTRICTIONS
  252.  
  253. Only one version of AEMail can be running at a time.  If you are using
  254. AEMail as a "mailto" mail agent in a browser, you can not have AEMail
  255. running when you invoke your browser if you expect to send any email from
  256. your browser.  AEMail will be automatically loaded from the browser when
  257. you click on a "mailto:" link.
  258.  
  259. This same restiction applies if you call AEMail from an external program
  260. to Queue or Send a message created by that program.
  261.  
  262. The "Drag Select" option for message list will only work with AmigaDOS 3.0
  263. or above.
  264.  
  265. While AEMail appears to work fine with a standard configured AMIGA, there
  266. are some possible problems with "system addons" that might not behave
  267. correctly with AEMail.
  268.  
  269. One such problem had been with hacks or commodities that moved a window to
  270. the front when you clicked into it such as the "Click-To-Front" commodity.
  271. The folder window disappeared.  That problem has been corrected.  Any
  272. other hack or commodity that automatically brings the current window to
  273. front either when you click on it or when you pass the cursor over it,
  274. should work now.  Please let me know if you are still having problems.
  275.  
  276. Another commodity that causes problems with AEMail is one that
  277. automatically activates the window under the mouse pointer (AutoPoint).
  278. Since AEMail uses multiple windows, it controls which window is active at
  279. any point in time.  It is not always the window under the mouse pointer
  280. since that might not cause AEMail to react properly.  As a result, if
  281. you activate AutoPoint while AEMail is active, you will experience
  282. flashing windows as AEMail switches control away from the window under the
  283. mouse pointer.
  284.  
  285. Other system configurations may also cause problems with AEMail.  If you
  286. encounter one of these, please send me e-mail describing the problem and
  287. what "add-on" you were using.  If it is a public domain program, it would
  288. be helpful if you included the program as an attached archive to your
  289. message.  (see Section VI, Command Icon Strip:  Compose A message).
  290.  
  291. When you call an editor that requires a stack size larger than the default
  292. stack size and that program does not create it's own stack, you will have
  293. to create a script for that editor and set the stack size from that
  294. script.  Increasing the stack size of AEMail will not work because AEMail
  295. establishes it's own stack size and called programs do not inherit stack
  296. size from the calling program.
  297.  
  298. If you are having problems with editors and stack size, you can use the
  299. supplied script for CED (s:AEMced.scr) and modify it to your
  300. specifications.  One warning, however, if you call a word processor you
  301. will need to ALWAYS save the file as ASCII and that program must be able
  302. to accept an already existing ASCII file when it is called.
  303.  
  304. You can send me e-mail by using the Address Book Nickname AEMAIL.  (see
  305. also Section X, Bug Reports and Suggestions)
  306.  
  307.                                REGISTRATION
  308.  
  309. AEMail is now shareware.  Versions prior to 1.15 were "freeware".  A
  310. shareware fee of $30 is requested for AEMail.  The shareware fee (US Funds
  311. only) should be sent to:
  312.  
  313.     John Zacharias
  314.     10004 Vanguard Drive
  315.     Sacramento, CA 95827
  316.     USA
  317.  
  318. You must include your Real Name and email address with your remittance.  A
  319. handy form has been provided in the file "registration.form" which you can
  320. print out and use for this purpose.  If you have more than one email
  321. address with more than one AEMail_Mail directory, please include ALL these
  322. addresses on the "registration.form".
  323.  
  324. The "registration.form" has an icon which, if you double click on it, will
  325. use the "PrintFiles" program in your SYS:Tools directory to print out the
  326. registration form.
  327.  
  328. Your registration will be acknowledged by email that must be received by
  329. AEMail.  AEMail version 1.43 does have several features that are not
  330. implemented for un-registered users and, in addition for un-registered
  331. users, the message display will be slowed down.
  332.  
  333. The features in AEMail 1.43 that are not available to un-registered users
  334. are:
  335.  
  336.     Ability to use multiple signature files.
  337.     Ability to add user defined headers to a message.
  338.     You will not be able to shrink/expand group displays in the Address
  339.         Book displays.  The standard Address Book display will have
  340.         expanded group displays and the Compose window address book
  341.         display will have only the group header displayed.
  342.     Enhanced speed on message display.
  343.     Password protection for separate configurations.
  344.     Filtering messages on "Other Message Hdrs".
  345.     Filtering messages on the content of the message body.
  346.  
  347. Future versions of AEMail may also have enhancements that will only be
  348. available to registered users.
  349.  
  350. For the un-registered "Freeware" version, permission is given to test and
  351. evaluate the program in return for feedback on the use of the program and
  352. reporting of any bugs encountered.
  353.  
  354. I do ask, however, that, in return for the use of this product, you inform
  355. me of any suggestions you have and of any bugs that you encounter.  You
  356. can do that by sending e-mail to me using the Nickname AEMAIL which can be
  357. found in your Address Book when you first load AEMail.  (see also Section
  358. X, Bug Reports and Suggestions)
  359.  
  360. --------------------------------------------------------------------------
  361.   WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING
  362. --------------------------------------------------------------------------
  363.  
  364. When you send your first message with any new version of AEMail, a special
  365. "Notification" message will be sent to me at jzachar@calweb.com.  Besides
  366. the normal header information, the body of this message will contain the
  367. following information (obtained from your configuration file):
  368.  
  369.     Your email address
  370.     Your Real Name
  371.     Your POP3 Server name
  372.     Your SMTP Server name
  373.     Your SMTP Domain Name
  374.     Your editor call
  375.     The version of the Exec (OS) that you are using
  376.     Your Display ID (from the screen mode setting)
  377.     Your Overscan Type (from the screen mode setting)
  378.     Base configuration file name
  379.     Currently active configuration file name
  380.     Mail Directory
  381.  
  382. This information is provided to help me determine and debug problems with
  383. AEMail.  Future versions may contain more or less information as the need
  384. arises.
  385.  
  386. Most of the Internet information is public information and can be obtained
  387. from your service provider.
  388.  
  389. I WILL KEEP THIS INFORMATION IN STRICT CONFIDENCE.  IF YOU DO NOT WANT
  390. THIS INFORMATION DIVULGED TO ME, DO NOT USE AEMAIL!
  391.                                  -----------------
  392.  
  393. I am including this warning because of concerns expressed to me by some
  394. people.
  395.  
  396. --------------------------------------------------------------------------
  397.   WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING
  398. --------------------------------------------------------------------------
  399.  
  400. This "notification" message will also give me the opportunity to inform
  401. all users of updates to AEMail by e-mail.  When I recieve the notification
  402. message your email address is placed in a database for informing you of
  403. updates.  If you do not want to be so informed, send me email to that
  404. effect and your name will be removed from the database.
  405.  
  406. The notification message will not appear in your PENDING folder although
  407. you will see it in your SENT folder after the notification message has
  408. been sent.  You will not have an opportunity to change any of the
  409. information.  If you feel some of the information is in error, you can
  410. correct it by sending me a separate email message.
  411.  
  412. Please note that a new notification message will be sent when you upgrade
  413. to a new version of AEMail.  This lets me know which version you are
  414. using.  Some of the data in future notification messages may also change
  415. to help give me feedback on how AEMail is being used and what setup you
  416. are using.
  417.  
  418. Also, if you are using multiple configuration files, a separate
  419. notification message will be sent the first time you send mail with any
  420. particular configuration.  If you re-install AEMail for any reason you may
  421. have an additional Notification message sent.
  422.  
  423.  
  424.                             III. INSTALLATION
  425.  
  426. The AEMail Install Script uses the Installer program first provided by
  427. Commodore and later revised by Amiga Technologies.  You should use the
  428. Install_AEMail script to install AEMail.  It is not recommended that you
  429. attempt to install AEMail by hand since some actions are necessary through
  430. the install script.  This is especially true if you are attempting to
  431. install a registered version with the supplied diskette!
  432.  
  433.     Installer and Installer project icon
  434.     (c) Copyright 1995-96 Escom AG.  All Rights Reserved.
  435.     Reproduced and distributed under license from Escom AG.
  436.  
  437.     INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  438.     NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY
  439.     OR RESPONSIBILITY IS ASSUMED.
  440.  
  441. To install AEMail simply double click on the "Install_AEMail icon".  The
  442. install script provides two user levels that the user can choose:
  443.  
  444.     Intermediate    (control of configuration parameters only)
  445.     Expert          (control of configuration and where files are placed)
  446.  
  447. The Install script makes an attempt to determine which TCP/IP stack that
  448. you have installed.  This controls which defaults will be taken.  The way
  449. the install scripts knows which TCP/IP stacks are present is as follows
  450. (you must have installed the particular stack before installing AEMail):
  451.  
  452.     AmiTCP:     This is controlled by the presence of the AmiTCP: assign
  453.                 statement and the presence of the AmiTCP:bin drawer.
  454.  
  455.     Miami:      This is controlled by the presence of the Miami: assign
  456.                 statement.  When you installed Miami you should have let
  457.                 the install create the Miami: assign.  This was only
  458.                 available under later versions of Maimi.
  459.  
  460.                 While the Miami: assign is not an absolute requirement
  461.                 if you are using Miami, it is required if you intend
  462.                 to use the supplied "startnet.miami" and "stopnet.miami"
  463.                 scripts supplied with this archive.  The scripts will
  464.                 not even be moved to your AEMail drawer if the Miami:
  465.                 assign is not present.
  466.  
  467.     TermiteTCP: This is controlled by the presence of the TermiteTCP.prefs
  468.                 envronomental variable.  Also, if you want to pick up
  469.                 some of the other TermiteTCP variables, such as email
  470.                 address, you must have run TermiteTCP prior to installing
  471.                 AEMail (TermiteTCP does not have to be online, however).
  472.  
  473. The action that takes place at during the install is slightly different
  474. depending on whether AmiTCP has been installed or not.  The installation
  475. script determines if AmiTCP is installed by checking for an assignment to
  476. AmiTCP:.  This AmiTCP:  assignment was automatically created when you
  477. installed AmiTCP.
  478.  
  479. If the AmiTCP:  assignment is present, it will determine where the
  480. installation script will place the AEMail executable.  For AmiTCP the
  481. executable is placed in the AmiTCP:bin drawer.  If this drawer is not
  482. present, the placement of the executable defaults to an "AEMail" drawer
  483. (created by the script if it does not already exist) on the largest
  484. partition on your hard drive.
  485.  
  486. If you wish to control where AEMail will be placed, you will need to
  487. execute the Install script at the "Expert" user level.
  488.  
  489. The reason that AEMail is placed in the AmiTCP:bin drawer if the AmiTCP:
  490. assignment is present, is that the assumption is made that you are using
  491. AmiTCP.  The "startnet" and "stopnet" scripts should be in the same
  492. directory that contains AEMail if they are to work without modification.
  493.  
  494. If you select the Intermediate user level, the following actions will be
  495. taken:
  496.  
  497.     The AEMail executable file will be placed in AmiTCP:bin or, if the
  498.         AmiTCP: assignment is not present, on the largest partition on
  499.         your hard drive.
  500.  
  501.         Note: No special directory will be created if AmiTCP:bin is
  502.         present, otherwise a directory called "AEMail" will be created
  503.         for containing the AEMail executable.  When the installation
  504.         script terminates it will tell you where it placed the AEMail
  505.         executable.
  506.  
  507.         The AREXX scripts StartNet.Miami and StopNet.Miami will also
  508.         be moved to this drawer if you have Miami installed on your
  509.         system as determined by a Miami: assignment.
  510.  
  511.     Your AEMail mail directory will normally be a directory called
  512.         AEMail_Mail in AmiTCP: or, if AmiTCP: was not present, in the
  513.         AEMAIL directory. The AEMail mail directory will be assigned to
  514.         AEMAIL:.  If an AEMAIL: assignment already exists, that directory
  515.         will be used as the mail directory except that it will be
  516.         renamed to AEMail_Mail if it had been named something else.
  517.         This operation is automatic and makes updating the AEMail program
  518.         easy without disturbing your existing mail files.
  519.  
  520.     The documentation files that you want copied will be copied to a drawer
  521.         called "documentation" in the drawer which contains the AEMail
  522.         executable.
  523.  
  524.     If you want the AEMail.readme file, it will be copied to the directory
  525.         containing your AEMail executable.
  526.  
  527.     A handy registration form called "registration.form" will be available
  528.         in your main AEMail directory.  It has an icon which, if you double
  529.         click on it, will use the "PrintFiles" program in your SYS:Tools
  530.         directory to print out the registration form.
  531.  
  532.     If you are running under AmigaDos 3.0 or greater, the supplied
  533.         mailcap file will be copied to the AEMail_Mail directory.
  534.         No mailcap file will be copied if you are using AmigaDos 2.1.
  535.  
  536.     An AEMAIL: assign statement will automatically be placed in your
  537.         S:User-Startup file.
  538.  
  539.     An "ASSIGN C: SYS:REXXC ADD" will also be added to your s:User-Startup
  540.         file to provide a path to your AREXX commands.
  541.  
  542. As noted above, the default drawer in which your documentation is placed is
  543. a drawer called "documentation" in the drawer containing your AEMail
  544. executable.  This is different from prior versions where the documentation
  545. files were placed in the same drawer as the AEMail executable.  Your old
  546. documentation files WILL BE deleted by the installation script.  If you
  547. want these retained you will have to re-name them yourself.
  548.  
  549. If you select either user level you will also be able to provide
  550. configuration data that will be stored in the Tool Types parameters of the
  551. AEMAIL icon.  Further, if the AEMAIL:  assignment existed at the start of
  552. the installation that assignment will be used.  However, if the mail
  553. directory had been called something else, you will be asked if you want to
  554. rename it to AEMail_Mail.  If you select NO, the directory will not be
  555. renamed; however, a new AEMail_Mail directory will be created in the same
  556. parent directory and used for the AEMAIL:  assignment.
  557.  
  558. In addition to what is available for the Intermediate user, the Expert user
  559. will be able to select what directories will be used and will be able to
  560. copy the documentation files to a directory of his/her choice.  The Expert
  561. user will also be able to select an alternate location for a pre-existing
  562. mailcap file and, if running under AmigaDos 2.1, will be able to build
  563. their own mailcap file.
  564.  
  565. If you are updating from a previous version of AEMail, it is recommended
  566. that you install at the Intermediate level.  That will insure that all of
  567. your old assignments and mail files will be available.  Also, you should
  568. not try to configure AEMail with the Install script since you already have
  569. a configuration file assigned.
  570.  
  571. The one exception to this is if you are updating from a version of AEMail
  572. below 1.10.  In this case you will HAVE to install at the Expert level in
  573. order to locate where your old AEMail installation was placed.
  574.  
  575. Certain configuration parameters must be provided before AEMAIL will run.
  576. These configuration parameters are provided either by Tool Types in the
  577. AEMail icon or through a special configuration screen when you first run
  578. AEMail and saved in an aemail.cnfg file in the S:  directory.
  579.  
  580. The installation script will try to automatically configure certain items
  581. to default values.  These include the switch for deleting mail from your
  582. POP Server once it has been transferred to your Amiga and the switch for
  583. stripping duplicate messages.  The edit call will default to c:ed and will
  584. open the editor on the Workbench.  Also, if you installed TermiteTCP, the
  585. installation script will obtain your POP3 UserID and SMTP Domain Name as
  586. well as your email address from the ttcp-email-address environmental
  587. variable provided TermiteTCP has been run (not necessarily on-line) before
  588. the AEMail installation was performed.
  589.  
  590. The installation script will allow you to provide additional configuration
  591. parameters as Tool Types in your AEMail icon or to change the default ones.
  592. However, if you are updating from a prior version you may already have an
  593. aemail.cnfg file in your S:  directory which will override the Tool Types.
  594. If the S:aemail.cnfg file is present, you will be asked if you want to use
  595. it or if you want to re-configure using tool types.  If you select this
  596. option your current "s:aemail.cnfg" file will be renamed to
  597. "s:aemail.cnfg.old" and you can reconfigure through the installation
  598. script.  If you need to restore your old "s:aemail.cnfg" file you can
  599. rename the "s:aemail.cnfg.old" to "s:aemail.cnfg"
  600.  
  601. If these parameters are not provided by Tool Types (through the
  602. installation script) or by an existing configuration file, the
  603. Configuration screen will be displayed upon the initial startup of AEMail.
  604. You can not proceed beyond this configuration screen until certain required
  605. configuration parameters are provided.  The absolute minimum configuration
  606. parameters that must be provided are:
  607.  
  608.     POP3 UserID
  609.     Password
  610.     Your email Address
  611.     SMTP Domain Name
  612.     Edit Call
  613.  
  614. A POP Server name and a SMTP Server name must also be provided.  However,
  615. if they are missing AND, if the SMTP Domain Name has been specified,
  616. default values will be assigned to these items.  These default values will
  617. prepend 'POP." to the domain name for the POP server and 'SMTP.' to the
  618. domain name for the SMTP Server as defaults.  Please note:  these may NOT
  619. be correct for your POP and SMTP servers.  If they are not, you will have
  620. to edit the Configuration and make appropriate changes (see Configuration
  621. Parameters for Identify under Section IV.  Configuration in the doc file or
  622. the section on the Configuration screen in the .guide file).
  623.  
  624. If you have installed and ran TermiteTCP before you installed AEMail, the
  625. only configuration parameter you may have to provide is your password.  The
  626. POP3 UserID and the SMTP Domain Name are extracted from the email address
  627. that you gave TermiteTCP.  If these are not the correct values you will
  628. have to change them in the Identity page of the Configuration screen.
  629.  
  630. For AmiTCP or Miami users, you will need to provide your POP3 UserID and
  631. SMTP Domain name as well as your email address.
  632.  
  633. One of the things that is needed to run AEMail is an editor.  By default
  634. AEMail will use the AmigaDOS editor, ed, which comes with all Amigas.
  635. However, you can change this through the install to any editor that you
  636. want provided that you have specified that you want to configure AEMail
  637. when you do the install.
  638.  
  639. If you are using AmiTCP, it is recommended that you place AEMail in the
  640. same directory that contains your AmiTCP StartNet and StopNet scripts
  641. (usually AmiTCP:bin) although this is not an absolute requirement.  If the
  642. directory containing your StartNet or StopNet scripts is NOT the AmiTCP:bin
  643. directory or the scripts have names different from "startnet" or "stopnet",
  644. you will have to add the STARTNET and STOPNET tool types to your AEMail
  645. icon.  You can do that with the installation script at either the
  646. Intermediate or Expert user levels.
  647.  
  648. If you are using TermiteTCP, there are no Start Net or Stop Net scripts.
  649.  
  650. For Miami, special startnet.miami and stopnet.miami scripts have been
  651. provided with the install of AEMail.  If the Miami assign is present, the
  652. install script assumes the Miami startnet and stopnet scripts should be
  653. used over the AmiTCP ones.
  654.  
  655. SPECIAL NOTE FOR MIAMI USERS:  In the TCP/IP Settings page on Miami, the
  656. "Down when Offline" item should be checked and the settings SAVED.  If this
  657. item is not checked, it will take AEMail 80 seconds to determine that Miami
  658. is offline if Miami is loaded but not online.
  659.  
  660. The installation script will automatically create a directory for your
  661. email storage (mail and configuration files) and place TWO ASSIGN
  662. statements in your S:User-Startup file as follows:
  663.  
  664.     ASSIGN AEMAIL: [your-mail-directory-path]
  665.     ASSIGN C: SYS:REXXC ADD
  666.  
  667. The second assign statement is used to provide a path to your AREXX
  668. commands because the only paths visable when you run a program from the
  669. Workbench are the program directory and C:.
  670.  
  671. If you are using AmiTCP (as determined by the presence of the AmiTCP:
  672. assignment), the default directory that is created is AmiTCP:AEMail_Mail;
  673. otherwise, it will be a directory called AEMail_Mail in the AEMail
  674. directory that has been created.
  675.  
  676. If an AEMAIL:  assignment already exists, the AEMail_Mail directory will
  677. not be created nor will the existing mail or Configuration files in the
  678. directory be disturbed.
  679.  
  680. If you want to place the AEMail_Mail directory some place else you will
  681. have to specify the Expert user level when you perform the installation.
  682.  
  683. WARNING:  If you are updating and you change the AEMail_Mail directory you
  684. will lose all previous folder configuration data including you registration
  685. information if you are a registered user.  You will need to copy this data
  686. yourself from your old AEMail_Mail directory to the new AEMail_Mail
  687. directory.
  688.  
  689. If you are updating AEMail and you are using the same AEMail_Mail
  690. directory, you will be asked if you want to save your existing
  691. folder.config file to folder.config.old.  If you are updating from a
  692. version prior to 1.40, you should reply "Yes" to this request.  If you are
  693. re-installing version 1.40 or a later version, reply "No".  The format of
  694. the folder.config file changes once you add filters to any folders.  By
  695. having the folder.config.old file you can revert to an earlier version of
  696. AEMail by renaming folder.config.old back to folder.config.
  697.  
  698. The mail directory can start out empty.  The AEMail program will generate
  699. any necessary configuration and support files required.  The AEMail_Mail
  700. directory can be anywhere on any one of your hard drive partitions (or on a
  701. floppy or other read/writable media); it does not have to be in the AmiTCP:
  702. directory; but it must be mounted when you execute AEMail.
  703.  
  704. Special Note on Use of multiple configuration files:  The normal AEMail
  705. configuration file is s:aemail.cnfg.  Starting with version 1.13 you will
  706. be able to assign your configuration file to some other name and location
  707. (you will need the Expert user level to do this).  and this will become
  708. your base configuration.  Also, the installation will ONLY configure this
  709. base configuration.  You will have to use the Configuration screen to
  710. configure any other configuration files for other users.  See Section IV.,
  711. Configuration, in the doc files for other multiple user considerations.
  712.  
  713. As stated above, you will need a "mailcap" file if you want to display MIME
  714. mail attachments.  A sample mailcap file is provided on the AEMail program
  715. disk which uses MultiView to display audio, images, and video content types
  716. provided that you have the appropriate datatypes loaded into your system.
  717. This, of course, requires AmigaDos 3.0 or higher.  If you are using
  718. AmigaDos 2.1, the mailcap file needs to be modified to reflect the display
  719. programs that you want.  The installation script at the Expert level will
  720. help you do this.
  721.  
  722. If you are running under AmigaDos 3.0 or higher, the installation script
  723. will automatically move the supplied mailcap file to AEMAIL:  unless you
  724. specified a different location for a pre-existing mailcap file (Expert
  725. level only).
  726.  
  727. The mailcap file specifications are given later in this document and in
  728. the AEMail guide file.
  729.  
  730. AEMail gets the current time zone from either the locale.prefs file that
  731. is part of AmigaDos or the tz envronmental variable.  See "Handling of
  732. Time Zones" below for further information on this.
  733.  
  734. When the installation script terminates it will store the directory in
  735. which it placed AEMail in the Environmental variable AEMail_dir.  This
  736. facilitates updating to future releases of AEMail.  The version 1.30 and
  737. later installation scripts, at all installation levels, will look for this
  738. Environmental variable to try to determine where to place AEMail.
  739.  
  740. The AEMail icon that is created when AEMail is installed will have five
  741. Tool Types entered but commented out.  These are:
  742.  
  743.     ;PASSPROTECT=YES
  744.     ;FLDRFONT=
  745.     ;FLDRFONTSZ=
  746.     ;CONFIG=
  747.     ;MAIL_DIR=
  748.  
  749. These five Tool Types can not be duplicated by the configuration screen.
  750. Consult the AEMail.guide file for the purpose of each of these Tool Types.
  751. They can be activated by removing the ";" at the beginning of the tool type
  752. and adding the appropriate argument information after the "=" sign.  You
  753. can do this with the "Information" menu item in the Workbench Menus (click
  754. on the AEMail icon first before using the "Information" menu item).
  755.                      HANDLING OF TIME ZONES IN AEMAIL
  756.                      --------------------------------
  757.  
  758. AEMail will handle time zones in both full hour and half hour increments.
  759. AEMail uses either the "tz" environmental variable, a special "aem_tz"
  760. environomental variable, or the "locale.prefs" file that is part of
  761. AmigaDos to determine your local time zone.  The "locale.prefs" file will
  762. only allow for full hour time zone offsets.  You can use the "tz"
  763. environmental variable for half hour time zones, but, if this variable is
  764. used by other programs in your system it is suggested that you use the
  765. "aem_tz" variable instead.
  766.  
  767. To set the time zone in the "locale.prefs" file, execute the Locale
  768. program under your Prefs directory by double clicking on the Locale icon.
  769. At the bottom right of the Locale Preferences window you will see a world
  770. map with a white line through it that indicates the time zone that you are
  771. in.  To change this, click on the country you are in.  The white line will
  772. move to that position and the Time Zone heading at the top of the map will
  773. reflect the time zone offset for your part of the world.  Then click on
  774. the [Save] gadget at the bottom of the window.
  775.  
  776. Currently AEMail first looks for the environmental variables "aem_tz" or
  777. "tz".  The format for "tz" is dictated by SAS_C and should be aaabbbccc
  778. where aaa is the abbreviation for local standard time, bbb is the offset
  779. in hours from GMT (-11 to 12) which is SUBTRACTED from GMT to get the
  780. local standard time.  ccc is the abbreviation for local daylight savings
  781. time or "summer time" (in the United Kingdom or Europe).  If the time zone
  782. has daylight savings time this should be present even if daylight savings
  783. time is not currently in effect (contrary to the specification for "Tz"
  784. for the SAS-C compiler).  AEMail automatically determines when DST or
  785. "Summer Time" is in effect.
  786.  
  787. AEMail also recognizes an alternate form of "tz" where aaa and ccc can be
  788. abreviations longer than 3 characters.  This is desireable in some
  789. European countries.  AEMail will also recognize time zones in increments
  790. of one half hour.  To specify an half hour time zone, specify it as + or -
  791. hhmm.  As an example:  +230 would specify a time zone in which 2 and a
  792. half hours are SUBTRACTED from GMT.
  793.  
  794. You can enter the above with the "tz" environmental variable, but since
  795. this variable might be used with other programs in it's strict sense, an
  796. alternate environmental variable has been provided called "aem_tz".
  797.  
  798. If "aem_tz" is present it will take precedence over "tz".
  799.  
  800. If the "tz" or "aem_tz" environmental variables are not present, the
  801. system then attempts to get the time zone offset from the "locale.prefs"
  802. file.  Only the time zone offset is present in this file.  The
  803. abbreviations for local standard time and daylight savings time are
  804. obtained from a table that is by no means complete.  Only the time zone
  805. abbreviations for the United States, Canada, and the United Kingdom are
  806. contained in this table, so one of the environmental variables is
  807. preferred.
  808.  
  809. if neither the "tz" nor "aem_tz" environmental variables nor the
  810. "locale.prefs" file are present, the system defaults to CST with an offset
  811. of 6.
  812.  
  813. NOTE:  the standard header in an email message has the time zone offset
  814. sign reversed from that of the "locale.prefs" and the environmental
  815. variables.  AEMail automatically makes this reversal, so the offset should
  816. be set to positive for US time zones and negative for European time zones.
  817. They will appear as negative (for US) and positive (for Europe) in the
  818. Date:  header.
  819.  
  820. You can set the "tz" or the "aem_tz" environmental variables by using the
  821. SETENV AmigaDos Command.  This must be done from the shell.  The syntax to
  822. use is as follows:
  823.  
  824.     SETENV tz aaabbbccc                            (for tz) and
  825.     SETENV aem_tz aaaaaaaaabbbbbccccccccc          (for aem_tz)
  826.  
  827. aaa, your local time zone abbreviation must always be present.  If you
  828. don't know your abbreviation (or don't want it in the header), use "xxx".
  829. If AEMail sees xxx it will assume that no abbreviation is present and it
  830. will be left off the Date:  header
  831.  
  832. bbb is the time offset in hours from GMT.  Plus indicates that you are
  833. west of GMT and minus indicates that you are east of GMT.  Acceptable
  834. values are -12 to 24.  If you want to specify a half our time zone it can
  835. be entered as hhmm.  If AEMail sees a value of 30 or above it assumes that
  836. a half hour increment is being used.  In this case -1200 to 2400 are
  837. acceptable.
  838.  
  839. If your time zone observes daylight savings time, ccc is the abbreviation
  840. to use for daylight savings time.  If ccc is not present, no adjustment
  841. will be made during the times of the year that daylight savings time is
  842. observed.
  843.  
  844. The result of the SETENV command is only in effect while your computer is
  845. on.  If you want to make the "tz"or "aem_tz" environmental variables
  846. always present enter the one of the following AmigaDOS command after the
  847. SETENV command:
  848.  
  849.     COPY ENV:tz ENVARC:tz                          (or)
  850.     COPY ENV:aem_tz ENVARC:aem_tz
  851.  
  852. Using the "tz" or "aem_tz" environmental variables gives you more control
  853. over which abbreviations will be used for your time zone.  However, the
  854. locale.prefs file may be more useful for those that prefer the "point and
  855. click" method of doing things.  To set the correct time zone for
  856. locale.prefs, enter the Locale editor in your Prefs drawer.  You will see
  857. a time zone map with which you can move the white strip indicating the
  858. time zone on the map.  Click either to the left or right of the strip to
  859. move the strip.  The correct time zone offset for standard time will be
  860. shown at the top of the map.
  861.  
  862. Since the locale.prefs does not have any abbreviations, AEMail makes
  863. certain assumptions as to what the abbreviation should be.  These
  864. assumptions are as follows:
  865.  
  866. Time Zone Name           Standard    DST  -----------Time Zone-----------
  867.                          Time             (in "locale")  (in email Date:)
  868.  
  869. Greenwich Mean Time      GMT*        BST       0              +0000
  870.  
  871. Atlantic Time            AST         ADT       4              -0400
  872. Eastern Time (US)        EST         EDT       5              -0500
  873. Central Time (US)        CST         CDT       6              -0600
  874. Mountain Time (US)       MST         MDT       7              -0700
  875. Pacific Time (US)        PST         PDT       8              -0800
  876. Yukon Time               YST         YDT       9              -0900
  877. Hawaiian Time            HST         ---      10              -1000
  878.  
  879. International Date Line  IDL         ---      12              -1200
  880.  
  881. --- indicates this time zone does not observe DST
  882.  
  883. *Note:  GMT (Greenwich Mean Time) is also known as UTC or Universal Time
  884. Coordinated.
  885.  
  886. If you want to use a different abbreviation or control whether DST is used
  887. or not, you should use the "tz" or "aem_tz" environmental variable.
  888.  
  889. DST in the United States and Canada begins on the first Sunday in April.
  890.  
  891. "Summer Time" in the United Kingdom and Europe begins on the last Sunday
  892. in March.
  893.  
  894. Both DST and "Summer Time" end on the last Sunday in October.
  895.  
  896.                             IV. CONFIGURATION
  897.  
  898. The configuration of AEMail is provided by parameters presented as Tool
  899. Types in the AEMail icon or by a Configuration screen that can be called
  900. up from within AEMail using the "Project/Configuratio/Edit.." menu item.
  901. All configuration items provided by Tool Types can also be provided by the
  902. Configuration screen with the exception of the MAIL_DIR=, the CONFIG=, the
  903. PASSPROTECT=YES, the FLDRFONT=, and the FLDRFONTSZ= Tool Types.  These
  904. five Tool Types have special uses, as explained below, that can not be
  905. duplicated by the configuration screen.
  906.  
  907. Certain configuration parameters can ONLY be provided by the Configuration
  908. screen.
  909.  
  910. Currently, setting the time zone that you are in is done outside the
  911. AEMail environment.  To set the time zone for AEMail see "HANDLING OF TIME
  912. ZONES IN AEMAIL" above.
  913.  
  914. If you are running AEMail from the shell or as a "mailto:" agent, it must
  915. be either pre-configured (through the S:aemail.cnfg file), or you will
  916. have to use the configuration screens for the configuration.  You can
  917. specify an alternate configuration file (other than S:aemail.cnfg) by
  918. using the config= parameter on the AEMail call line.
  919.  
  920. The first thing AEMail does when it is activated is check to see that
  921. certain configuration information has been provided either through Tool
  922. Types or as contained in the AEMail configuration file.  The necessary
  923. items are:
  924.  
  925.     POP3 UserID
  926.     Password
  927.     From Addr (your email address)
  928.     SMTP Domain Name
  929.     Edit Call
  930.  
  931. If these items have not been provided, the following requester will be
  932. immediately displayed:
  933.  
  934.     The following Configuration items are empty
  935.  
  936.     [list of empty items]
  937.  
  938.     They are required items!
  939.  
  940. The Pop Server call and the SMTP call will also be included in this list
  941. if the SMTP Domain Name was missing.
  942.  
  943. Also, the Edit Call item, if it is missing, will default to:
  944.  
  945.     C:ed %s
  946.  
  947. with the editor opening on the Workbench.  The only way the Edit Call can
  948. appear in the list is if the General Parameters page of the Configuration
  949. screen had been entered and the Edit call field cleared.
  950.  
  951. If this requester is displayed, you will be given the following choices:
  952.  
  953.        [Configure AEMAIL now]               [Cancel AEMAIL]
  954.  
  955. If you were to click on [Cancel AEMAIL], AEMail will terminate.  You can
  956. not proceed any further until you have entered these items with the
  957. Configuration screen or by providing them as Tool Types.
  958.  
  959. Clicking on the [Configure AEMAIL now] will bring up the Configuration
  960. screen which is described below following the description of the Tool
  961. Types.
  962.  
  963. Also, if "Mail Directory" appears in the list of empty items, it means
  964. that the AEMail:  assign is not in the system and the MAIL_DIR Tool Type
  965. has not been given.  There is no way you can provide this information
  966. through the Configuration screen.  You will have to either provide the
  967. ASSIGN statement or add the MAIL_DIR Tool Type.  If you use the standard
  968. install script, this should never be necessary.
  969.  
  970. PLEASE NOTE:  If you have included the ASSIGN AEMAIL:  statement in the
  971. S:user-startup file and that assignment includes embedded spaces in one of
  972. the directories in the assignment path, the asignment path MUST be
  973. surrounded with quotes.  The Install script for Version 1.43 automatically
  974. does this; however, the install scripts for AEMail versions prior to 1.20
  975. did not do this.
  976.  
  977. The three Tool Types, MAIL_DIR=, CONFIG=, and PASSPROTECT=YES have special
  978. uses.  CONFIG= is used to specify an alternate configuration file other
  979. than s:aemail.cnfg that AEMail is to open with.  MAIL_DIR= is used to
  980. specify a mail directory other than the one provided by the AEMAIL:
  981. assign.  It is used to provide an alternate location for the mail files.
  982. And PASSPROTECT=YES is used to password protect AEMail when you click on
  983. it's icon.  Using this Tool Type will call up a requester as soon as you
  984. load AEMail which will force you to enter the password that was configured
  985. for that instance of the configuration file.
  986.  
  987. If you have two or more users of AEMail on the same system and you want
  988. each user to have different locations for their mail files, you can
  989. establish an alternate location for one of the mail directories.  To do
  990. this, you will have to have two different AEMail icons with different
  991. names if they are in the same directory.  You can still have only one
  992. AEMail executable, however.
  993.  
  994. One of the icons will have to be a "Project" icon if you only want one
  995. AEMail executable.  To create the project icon execute the "IconEdit"
  996. program which is in your SYS:TOOLS directory.  When "IconEdit" is loaded,
  997. go to the Open menu and locate the icon for your AEMail executable.
  998. (don't confuse this with the icon for the AEMail drawer.  The AEMail
  999. executable icon looks like a mailbox).  Open this icon.  To change the
  1000. icon to a project icon, go to the Type menu in "IconEdit" and select
  1001. Project.  Then "Save as" using a different name for this new icon.
  1002.  
  1003. You are still not finished, however.  You must edit this icon using the
  1004. "Information" menu item on the Workbench menu.  First change the Project
  1005. line (it will say JUNK) to AEMail.  If you are in a different directory
  1006. then the AEMail executable, you will have to enter the full path name to
  1007. that directory.  Then add (or change) the CONFIG= Tool Type to reflect
  1008. where the configuration file is for that particular user and add (or
  1009. change) the MAIL_DIR= Tool Type to give the full path name of the mail
  1010. directory for that user.  Be sure to include the ending '/' after the
  1011. directory name.
  1012.  
  1013. If you want password protection (only available to registered AEMail
  1014. users) you should also add the Tool Type PASSPROTECT=YES.  Do this for
  1015. each icon that you want to password protect.
  1016.  
  1017. Please Note:  The Project icon will also inherit the Tool Types from the
  1018. main executable icon; however, if there is an identical Tool Type, the
  1019. Project icon's Tool Type will take precedence.
  1020.  
  1021. As an example, lets say you have two users named John and Jan.  John is
  1022. the primary user of AEMail.  You install AEMail (using any mode) in a
  1023. directory called HD1:AEMail and the default AEMAIL:  assign is set to:
  1024.  
  1025.     ASSIGN AEMAIL: HD1:AEMail/AEMail_Mail
  1026.  
  1027. If you wanted your configuration file to be John_aemail.cnfg in the AEMail
  1028. directory, you could add the following Tool Type to the AEMail icon in
  1029. HD1:AEMail (this can be done with the Install script as the expert mode or
  1030. through the Information menu):
  1031.  
  1032.     CONFIG=HD1:AEMail/John_aemail.cnfg
  1033.  
  1034. You could then create another directory in HD1:AEMail called Jan_mail.
  1035. This is where Jan's mail will go.  Execute "IconEdit" and create a project
  1036. icon that could be called "Jan's AEMail".  Now select the icon that you
  1037. just created and the Information item on the Workbench menus.  Change
  1038. Jan's CONFIG= Tool Type to:
  1039.  
  1040.     CONFIG=HD1:AEMail/Jan_aemail.cnfg
  1041.  
  1042. and add the MAIL_DIR= Tool Type as follows:
  1043.  
  1044.     MAIL_DIR=HD1:AEMail/Jan_Mail/
  1045.  
  1046. Then, when John wants to use his copy of AEMail and his files, he double
  1047. clicks on the main AEMail icon, and when Jan wants to use her copy she
  1048. double clicks on the one called "Jan's AEMail".  The one restriction is
  1049. that you cannot have both copies of AEMail running at the same time.  Each
  1050. set will be set up with different configuration files so that information
  1051. in these files can be different.
  1052.  
  1053. If you are a registered AEMail user you can also add the PASSPROTECT=YES
  1054. tool type to either of your icons.  Please note, however, if you place the
  1055. PASSPROTECT=YES Tool Type on the main AEMail executable icon (John's
  1056. AEMAIL), the project icon (Jan's AEMail) will act as if PASSPROTECT=YES
  1057. was placed on that icon even if it wasn't.  However, you can place
  1058. PASSPROTECT=YES on Jan's AEMail icon without placing it on the main AEMAIL
  1059. icon and the main AEMail will not be password protected.
  1060.  
  1061. You can also place the configuration files and mail drawers in different
  1062. main drawers.  If this is done you will have to remember to put the FULL
  1063. PATH NAME to the AEMail executable in the project icon.
  1064.  
  1065. Currently, the creation of the project icon and the modifications
  1066. mentioned above has to be done by hand.  In a future version of AEMail,
  1067. the installation script will be modified to do this automatically.
  1068.  
  1069. You can configure both instances of AEMail through either the Tool Types
  1070. in the appropriate icon or with the configuration screen when you execute
  1071. that particular instance of AEMail.
  1072.                                 TOOL TYPES
  1073.  
  1074. Tool Types have been provided to initially provide certain Configuration
  1075. information when AEMail is first activated without the need to build the
  1076. Configuration information through the Configuration screens.
  1077.  
  1078. To modify or delete any specific Tool Type, select the AEMail icon and
  1079. then select the "Information" item from the Workbench menu.  You will have
  1080. to select the appropiate Tool Type and modify it when it appears in the
  1081. string gadget below the Tool Type list.
  1082.  
  1083. The current Tool Types utilized by the program are:
  1084.  
  1085. INTERLACE=YES
  1086.  
  1087. Opens the AEMail Public Screen (AEMAIL-1) in hires, interlace mode.  If
  1088. this tool type is omitted, the screen will be opened as a hires,
  1089. non-interlaced screen.
  1090.  
  1091. You can actually have more control over the Screen Mode you desire by
  1092. selecting the "Set Screen Mode" button in the AEMail Configuration:
  1093. General Parameters configuration display.  Selecting a Screen Mode from
  1094. the Configuration display precludes the use of this Tool Type.
  1095.  
  1096.  
  1097. MAIL_DIR=directory-path
  1098.  
  1099. If you do not place the AEMAIL ASSIGN statement in your Startup-Sequence,
  1100. you can use this Tool Type to assign your mail directory.  This can also
  1101. be used to provide an alternate location to the AEMAIL Assign statement
  1102. when you have more than one instance of AEMail in your system.  This
  1103. parameter CAN NOT be provided with the Configuration screen.  (DEFAULTS TO
  1104. AEMAIL:  This assumes that the AEMAIL ASSIGN is present).  If you are
  1105. using a different directory, be sure and include the ending '/' at the end
  1106. of the directory path.
  1107.  
  1108.  
  1109. CONFIG=configuration-file
  1110.  
  1111. If you do not care to use the standard s:aemail.cnfg file for your
  1112. configuration data, but want a file named something else or in a different
  1113. location, you can use this tool type.  When AEMail opens it will look here
  1114. for the configuration file.  YOU MUST PRECEDE THE FILE NAME WITH THE FULL
  1115. PATH NAME.  This parameter CAN NOT be provided with the Configuration
  1116. screen, although the initial file can be created, saved, and edited from
  1117. the "Project/Configuration" menu.  (DEFAULTS TO s:aemail.cnfg)
  1118.  
  1119.  
  1120. MAILCAP_DIR=directory-path
  1121.  
  1122. Your mailcap file can reside in any directory you want.  Use this Tool
  1123. Type to assign the mailcap directory path.  If this parameter is missing,
  1124. the MAIL_DIR path will be used as the mailcap directory path.
  1125.  
  1126. The mailcap file must be called "mailcap".  Since the mailcap file follows
  1127. a standard format dictated by the internet, you can use the same mailcap
  1128. file used by another process.  That is the purpose of this Tool Type.
  1129.  
  1130. This parameter can also be provided with the Configuration Screen
  1131. (DEFAULTS TO AEMAIL:).
  1132.  
  1133.  
  1134. USERID=UserId
  1135.  
  1136. Enter your POP3 UserId for signing onto your POP Server on your Internet
  1137. provider (ISP).  This may be the same as the one initially used to sign
  1138. into your ISP.  It is also very possibly (but not always) the part of your
  1139. email address that precedes the @ sign.  Check with your ISP for what
  1140. should be used.
  1141.  
  1142. Example: my UserId is "jzachar" so I would enter
  1143.  
  1144.     USERID=jzachar
  1145.  
  1146. for this Tool Type.  THIS IS A REQUIRED PARAMETER, but it can be provided
  1147. with the Configuration Screen.
  1148.  
  1149.  
  1150. PASSWRD=your_password
  1151.  
  1152. Enter the password required for signing onto your POP3 server.  This may
  1153. or not be the same as that used to sign onto your Internet provider.  THIS
  1154. IS A REQUIRED PARAMETER, but it can be provided with the Configuration
  1155. Screen.
  1156.  
  1157. SPECIAL NOTE:  if the password is provided by a Tool Type it can be read
  1158. by anyone that performs an "Information" on the AEMail icon.  If you
  1159. provide the password through the Configuration screen, it can not be seen.
  1160.  
  1161.  
  1162. PASSPROTECT=YES (registered users only)
  1163.  
  1164. Use this Tool Type if you want to password protect your copy of AEMail.
  1165. This will call up a special password window when you first load AEMail
  1166. which will require you to enter your password before you procede.  You
  1167. will be given three chances to enter the correct password.  If the
  1168. password fails validation after the third try, AEMail will terminate.
  1169. This Tool Type is ignored for unregistered users.
  1170.  
  1171. The Password that is used is the one required for signing onto your POP3
  1172. server (see above).
  1173.  
  1174. DOMAIN=Domain_Name
  1175.  
  1176. Enter the Domain name used by your Internet provider's SMTP server.  It
  1177. very possibly is the same as the Domain part of your email address (the
  1178. part following the @ sign)
  1179.  
  1180. Example:  my Internet provider's domain name is "calweb.com" so I would
  1181. enter
  1182.  
  1183.     DOMAIN=calweb.com
  1184.  
  1185. for this Tool Type.  THIS IS A REQUIRED PARAMETER, but it can be provided
  1186. with the Configuration Screen.
  1187.  
  1188.  
  1189. FROM=your_email_address
  1190.  
  1191. Enter your FULL email address (i.e.  user@domain).  This is email address
  1192. that you are known by on the Internet.
  1193.  
  1194. Example:  my email address is "jzachar@calweb.com" so I would enter
  1195.  
  1196.     FROM=jzachar@calweb.com
  1197.  
  1198. for this tool type.  THIS IS A REQUIRED PARAMETER, but it can be provided
  1199. with the Configuration Screen.  If it is missing it defaults to
  1200. UserID@Domain.  This default action may NOT be correct for your situation,
  1201. so be sure to change it if required.
  1202.  
  1203.  
  1204. REALNAME=your_real_name
  1205.  
  1206. Enter your full name.  Example:
  1207.  
  1208.     REALNAME=John Zacharias
  1209.  
  1210. This is an OPTIONAL parameter, but if it is omitted your full name will
  1211. NOT be provided in the FROM:  address of any messages you send unless you
  1212. add it yourself when you compose a message.  This parameter can also be
  1213. provided with the Configuration Screen.
  1214.  
  1215.  
  1216. REPLYTO=reply-email-address
  1217.  
  1218. This is the email address that you want all replies directed to.  This may
  1219. be the same as your FROM email address or it can be a different address if
  1220. you want replies sent somewhere else.  This is an OPTIONAL parameter and
  1221. can also be provided with the Configuration screen.
  1222.  
  1223. The standard REPLY-TO address provided here can also be modified each time
  1224. you compose a message to send.
  1225.  
  1226.  
  1227. ORGANIZATION=organization-name
  1228.  
  1229. This parameter is OPTIONAL and, if present, will provide an Organization:
  1230. header for any message that you compose and send.  This parameter can also
  1231. be provided with the Configuration screen.
  1232.  
  1233.  
  1234. POP_SERVER=your_POP_host
  1235.  
  1236. Enter the name of your POP host.  This sometimes is "pop." or "mail."
  1237. prepended to your Domain name.  As an example, mine is "pop.calweb.com" so
  1238. I would enter
  1239.  
  1240.     POP_SERVER=pop.calweb.com
  1241.  
  1242. If this parameter is omitted, "pop.[domain]" will be generated as your
  1243. POP_SERVER name provided a domain name has been specified.  If your's uses
  1244. a differnt name you should use this Tool Type or change it with the
  1245. Configuration screen.
  1246.  
  1247. This parameter can also be provided by the Configuration Screen.
  1248.  
  1249.  
  1250. SMTP_SERVER=your_SMTP_host
  1251.  
  1252. Enter the name of your SMTP host.  This sometimes is "smtp."
  1253. or "mail." prepended to your Domain name.  As an example,
  1254. mine is "smtp.calweb.com" so I would enter
  1255.  
  1256.     SMTP_SERVER=smtp.calweb.com
  1257.  
  1258. If this parameter is omitted, "smtp.[domain]" will be generated as your
  1259. SMTP_SERVER name provided a domain name has been specified.  If your's
  1260. uses a differnt name you should use this Tool Type or change it with the
  1261. Configuration screen.
  1262.  
  1263. This parameter can also be provided by the Configuration Screen.
  1264.  
  1265.  
  1266. EDITOR=call_line_for_your_editor
  1267.  
  1268. Enter the full call parameter required to activate your editor from the
  1269. shell.  Use "%s" where you would place the file name.
  1270.  
  1271. You are no longer restricted to an editor call that does not remain in
  1272. control when you call it as you were with previous versions of AEMail.  In
  1273. other words, a direct call to CygnusEd (CED) is acceptable.
  1274.  
  1275. If your editor opens on the workbench screen rather than a screen of its
  1276. own, you should prepend "WB;" in front of your editor call.  As an
  1277. example, the standard AmigaDos ED program always opens on the workbench
  1278. screen.  An example edit call for the Amiga ED would be as follows:
  1279.  
  1280.     EDITOR=WB;c:ed %s WINDOW raw:0/0/640/400/AEMailCompose
  1281.  
  1282. The window statement in the above call is used to create a full screen
  1283. window with an interlaced display.
  1284.  
  1285. If you are not using an interlaced display you can remove the WINDOW
  1286. parameter or change it to raw:0/0/640/200/AEMailCompose.  You can, of
  1287. course, make other changes to the window parameters if you desire.
  1288.  
  1289. If you are using the Amiga ED you should probably also remove or rename
  1290. the ED-Startup file in the S:  directory so that you will have a full set
  1291. of ED menus.
  1292.  
  1293. If this Tool Type is missing, the following call is the default editor
  1294. call:
  1295.  
  1296.     EDITOR=WB;c:ed %s
  1297.  
  1298. This defaults to using the Amiga Ed program for your editor.
  1299.  
  1300. The specification for your editor call can also be provided by the
  1301. Configuration Screen.  A convenient check mark item is provided in the
  1302. Configuration Screen to open the editor on the Workbench screen.
  1303.  
  1304.  
  1305. TCPLOG=name_of_log_file
  1306.  
  1307. Enter the full path, including the file name, of your TCP logging file.
  1308. If this parameter is omitted, it defaults to "tcplog" in the directory
  1309. AEMail is loaded from.
  1310.  
  1311. This parameter does not start TCP logging, it only establishes the name of
  1312. the TCPLOG file.  Logging can be started or stopped at any time by a menu
  1313. item (see Section VII.  AEMAIL MENUS - TCP Logging File under the TCP/IP
  1314. menu).  The Logging file can be active when AEMail is started through a
  1315. parameter in a Configuration Screen item.
  1316.  
  1317. When TCP logging is active, all sends and receives over the TCP/IP
  1318. connection are recorded to this file.  Each time an AEMail session is
  1319. started and logging is active, data is appended to this file.  As a result
  1320. this file can become quite large.  IT IS THE USER'S RESPONSIBILITY TO
  1321. PERIODICALLY PURGE (DELETE) THIS FILE.  A menu item is provided to perform
  1322. this purge and another item to display the log file with your editor from
  1323. within AEMail.
  1324.  
  1325. NOTE:  When there is a need to report a problem, especially with your
  1326. TCP/IP connection, the TCP Logging file should be set active and a copy of
  1327. the resultant file provided with any feedback on the program activity (see
  1328. Section X, Bug Reports & Suggestions).  The file can be sent as an
  1329. attachment to any message that you send to AEMail.  You probably should
  1330. compress the file with LHA before attaching it as an "Applicatio/Octet
  1331. Stream" content type with "encoded binary" encoding.
  1332.  
  1333. I have discovered that this file comes in handy when analysing problems
  1334. with your Internet provider since it time stamps all entries to the
  1335. nearest second.
  1336.  
  1337. This parameter can also be provided by the Configuration Screen.
  1338.  
  1339.  
  1340. DELETEMAIL=YES
  1341.  
  1342. This Tool Type sets the initial value of the "Delete Host Mail" menu item
  1343. under the RETRIEVE MSGS menu.  If this Tool Type is entered, the "Delete
  1344. Host Mail" menu item will be initially checked.  See the "Delete Host
  1345. Mail" item under section VII.  AEMAIL MENUS below.
  1346.  
  1347. This parameter can also be set by the Configuration Screen or the
  1348. DELETEMAIL flag can be set with a menu item and its state can be saved in
  1349. the configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1350. item.
  1351.  
  1352.  
  1353. FULLHEADER=YES
  1354.  
  1355. This Tool Type sets the initial value of the "Display Full Hdr" menu item
  1356. under the MESSAGES menu.  If this Tool Type is entered, the "Display Full
  1357. Hdr" menu item will be initially checked.  See the "Display Full Hdr" item
  1358. under section VII.  AEMAIL MENUS below.
  1359.  
  1360. This parameter can also be set by the Configuration Screen or the
  1361. FULLHEADER flag can be set with a menu item and its state can be saved in
  1362. the configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1363. item.
  1364.  
  1365.  
  1366. STRIPDUPS=YES
  1367.  
  1368. This Tool Type sets the initial value of the "Excl Dup Msgs" menu item
  1369. under the RETRIEVE MSGS menu.  If this Tool Type is entered, the "Excl Dup
  1370. Msgs" menu item will be initially checked.  See the "Excl Dup Msgs" item
  1371. under section VII.  AEMAIL MENUS below.
  1372.  
  1373. This parameter can also be set by the Configuration Screen or the
  1374. STRIPDUPS flag can be set with a menu item and its state can be saved in
  1375. the configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1376. item.
  1377.  
  1378.  
  1379. HDRINREPLY=YES
  1380.  
  1381. This Tool Type sets the initial value of the "Incl Hdr in Resp" menu item
  1382. under the MESSAGES menu.  If this Tool Type is entered, the "Incl Hdr in
  1383. Resp" menu item will be initially checked.  See the "Incl Hdr in Resp"
  1384. item under section VII.  AEMAIL MENUS below.
  1385.  
  1386. This parameter can also be set by the Configuration Screen or the
  1387. HDRINREPLY flag can be set with a menu item and its state can be saved in
  1388. the configuration file by selecting the "PROJECT/CONFIGURATION/SAVE" menu
  1389. item.
  1390.  
  1391.  
  1392. STARTNET=call_line_for_your_startnet_script
  1393.  
  1394. This Tool Type is used to specify the call line for your script that
  1395. starts up your TCP/IP stack.  If you are using AmiTCP, this is normally
  1396. the file "startnet" in the AMITCP:bin directory.  If you are using Miami,
  1397. an AREXX script has been provided with the AEMail archive called
  1398. "startnet.miami" and it is located in the AEMail program directory.
  1399.  
  1400. A full path name to that script must be entered.  If the script is an
  1401. AREXX script it should be preceded with "rx " (a space is between the rx
  1402. and the script name).  The standard AmiTCP startnet script is NOT an AREXX
  1403. script even though it uses AREXX commands.  It is an AmigaDOS script.  The
  1404. Miami script, on the other hand, is an AREXX script.
  1405.  
  1406. If you do not use the STARTNET Tool Type, AEMail assumes that you do not
  1407. have a script.  If you activate the "Start Net" item in the TCP/IP menu
  1408. and you don't have a startnet script, AEMail's action is to iconify and
  1409. allow you to manually start your TCP/IP stack.  Connect using the method
  1410. prescribed by your TCP/IP stack.  When you un-iconify AEMail, AEMail will
  1411. immediately check to see if any mail is present on your POP server.
  1412.  
  1413. If you are using a TCP/IP stack that can't use a script (such as
  1414. TermiteTCP) or you have no script to make connection to your Internet
  1415. provider, then this Tool Type should not be used.  Then if you select the
  1416. StartNet menu item, the system will automatically iconify AEMail and
  1417. present the Workbench screen.
  1418.  
  1419. Since AmiTCP Demo Version 4.0 puts up a requester on the workbench screen
  1420. that must be responded to, AEMail will automatically switch to the
  1421. Workbench screen before calling this script.  Although the Miami script
  1422. does not require manual intervention, the default action is to also switch
  1423. to the Workbench screen since this allows you to see the action of the
  1424. dialer.  When the connection has been made using Miami, the screen will
  1425. automatically switch back to the AEMail screen.
  1426.  
  1427. The Start Net script can also be set by the TCP/IP page of the
  1428. Configuration Screen.  The Configuration screen will also allow you to set
  1429. whether or not the system switches to the Workbench screen when the Start
  1430. Net script is executed.
  1431.  
  1432. Note:  Check your startnet script to be sure that full path names are
  1433. specified.  If you are using the standard AmiTCP startnet script, that
  1434. script may not be executed from the Amitcp:bin directory (unless AEMail is
  1435. executed from there).  Therefor, you should verify that Amitcp:bin/ is
  1436. prepended to all calls to functions within the AmiTCP/bin directory within
  1437. the script.  Pay particular attention to the "online" call - it should be
  1438. AmiTCP:bin/online.  You will also have to move the AREXX commands (such as
  1439. WaitForPort and RX) to the C:  directory.  The installation script will
  1440. automatically do this for you.
  1441.  
  1442.  
  1443. STOPNET=call_line_for_your_stopnet_script
  1444.  
  1445. This Tool Type is used to specify the call line for your script that
  1446. terminates your TCP/IP connection.  If you are using AmiTCP, this is
  1447. normally the file "stopnet" in the AMITCP:bin directory.  If you are using
  1448. Miami, an AREXX script has been provided with the AEMail archive called
  1449. "stopnet.miami" and it is located in the AEMail program directory.
  1450.  
  1451. A full path name to that script must be entered.  If the script is an
  1452. AREXX script it should be preceded with "rx " (a space between the rx and
  1453. the script name).  The standard AmiTCP startnet script is NOT an AREXX
  1454. script even though it uses AREXX commands.  It is an AmigaDOS script.  The
  1455. Miami script, on the other hand, is an AREXX script.
  1456.  
  1457. If you do not use the STOPNET Tool Type, AEMail assumes that you you do
  1458. not have a script.  If you activate the "Stop Net" item in the TCP/IP menu
  1459. and you don't have a stopnet script, AEMail's action is to iconify and
  1460. allow you to manually stop your TCP/IP stack.  You can then disconnect
  1461. using the method prescribed by your TCP/IP stack.  When you un-iconify
  1462. AEMail, AEMail will test to see if you are, in fact, disconnected.
  1463.  
  1464. If you are using a TCP/IP stack that can't use a script (such as
  1465. TermiteTCP) or you have no script to terminate your connection to your
  1466. Internet provider, then this Tool Type should not be used.  Then if you
  1467. select the Stop Net menu item, the system will automatically iconify
  1468. AEMail and present the Workbench screen.
  1469.  
  1470. The Stop Net script can also be set by the TCP/IP page of the
  1471. Configuration Screen.  The Configuration screen will also allow you to set
  1472. whether or not the system switches to the Workbench screen when the Stop
  1473. Net script is executed.  Since terminating your connection with a script
  1474. usually does not require any visual interaction, the default action is to
  1475. NOT switch to the Workbench screen.
  1476.  
  1477. Note:  Check your stopnet script to be sure that full path names are
  1478. specified.  If you are using the standard AmiTCP stopnet script, that
  1479. script may not be executed from the Amitcp:bin directory (unless AEMail is
  1480. executed from there).  Therefor, you should verify that Amitcp:bin/ is
  1481. prepended to all calls to functions within the AmiCCP:bin directory within
  1482. the script.  Pay particular attention to the "offline" call - it should be
  1483. AmiTCP:bin/offline.  You will also have to move the AREXX commands (such
  1484. as WaitForPort and RX) to the C:  directory.  The installation script will
  1485. automatically do this for you.
  1486.  
  1487.  
  1488. AUTOCONNECT=YES
  1489.  
  1490. When AEMail is first activated it attempts to determine if you are
  1491. connected to your Internet provider.  If you are not and this Tool Type is
  1492. present, AEMail will automatically run your StartNet script.
  1493.  
  1494. Before activating this Tool Type, you should check to see if AEMail can
  1495. activate your TCP/IP stack properly using the StartNet menu item.  If
  1496. there are any problems with your StartNet activation they will show up at
  1497. this time rather than constantly every time you try to activate AEMail.
  1498.  
  1499. WARNING:  You should not use this Tool Type if a StartNet script is not
  1500. present for your TCP/IP stack.  You should activate your TCP/IP stack
  1501. manually before you start AEMail.
  1502.  
  1503.  
  1504. This parameter can also be set by the Configuration Screen.
  1505.  
  1506.  
  1507. FLDRFONT=fontname
  1508.  
  1509. This allows the user to specify their own font for the folder strip.
  1510. Since the size of the folders in the folder strip is constrained by the
  1511. size of the font that you use, you can specify a different font and font
  1512. size (see FLDRFONTSZ= below) to reduce the size of the folder strip.  If
  1513. not specified the folder font will default to the standard Topaz 8 font.
  1514. When you enter the font name it is entered WITHOUT the .font suffix and it
  1515. must be found in your FONTS: directory.
  1516.  
  1517. If you use FLDRFONT= without FLDRFONTSZ=, the resulting font will be the
  1518. one you specify at the 8 size.  If no such size exists in your FONTS:
  1519. directory, it will be computed.  This can sometimes be unsatisfactory.
  1520.  
  1521. Currently this parameter can only be provided by a Tool Type.  A future
  1522. version will allow you to specify the font through a special configuration
  1523. page.
  1524.  
  1525.  
  1526. FLDRFONTSZ=fontsize
  1527.  
  1528. This Tool Type is used in conjuction with the FLDRFONT= Tool Type
  1529. described above.  These two Tool Types allow the user to specify their own
  1530. font and font size for the folder strip.  Since the size of the folders in
  1531. the folder strip is constrained by the size of the font that you use, you
  1532. can specify a different font and font size to reduce the size of the
  1533. folder strip.  If not specified the folder font will default to the
  1534. standard Topaz 8 font.
  1535.  
  1536. If you use FLDRFONTSZ= without FLDRFONT=, the resulting font will be Topaz
  1537. with a computed font size corresponding to this parameter
  1538.  
  1539. Currently this parameter can only be provided by a Tool Type.  A future
  1540. version will allow you to specify the font through a special configuration
  1541. page.
  1542.  
  1543.  
  1544.                            CONFIGURATION SCREEN
  1545.  
  1546. The Configuration screen is displayed on the Workbench when you click on
  1547. the [Configure AEMAIL now] button or when you select the
  1548. "Project/Configuration/Edit" menu item.  The configuration screen is
  1549. divided into four pages with the page name shown with a button at the top
  1550. of the page area.  When you click on any one button that button will
  1551. become highlighted and the appropriate page will be displayed.
  1552.  
  1553. The four pages are:
  1554.  
  1555.     IDENTITY
  1556.     TCP/IP
  1557.     PATHS
  1558.     GENERAL
  1559.  
  1560. At the bottom of the Configuration screen is a row of buttons as follows:
  1561.  
  1562.  
  1563.                                           [USE] [SAVE] [SAVE AS] [CANCEL]
  1564.  
  1565.  
  1566. Clicking on any one of these buttons will perform the requested action,
  1567. regardless of which page you are on, and return you to the main AEMail
  1568. screen.
  1569.  
  1570. If you want the configuration information to apply only to this AEMail
  1571. session select [USE].  If you want to make the configuration permanent,
  1572. select [SAVE].  This will cause a new configuration file to be written and
  1573. will also signal that the configuration file is to take precedence over
  1574. the Tool Types the next time AEMail is loaded.
  1575.  
  1576. Normally the configuration file is either s:aemail.cnfg or the file
  1577. specified in the CONFIG= tool type.  However, if you opened another
  1578. configuration file with the "Project/Configuration/Open..." menu item,
  1579. that configuration file will be the current active one.
  1580.  
  1581. The [SAVE AS] button does the same as [SAVE] except that a file requester
  1582. will be displayed that will allow you to rename and place the
  1583. configuration file anywhere you wish.  WARNING:  when you use the [SAVE
  1584. AS] button, AEMail assumes that that file is now your active configuration
  1585. file and any saves occuring after that will be to that file.  To return to
  1586. the base configuration (either s:aemail.cnfg or the CONFIG= file), use the
  1587. "Project/Configuration /Reset" menu item.
  1588.  
  1589. [CANCEL] will abort the operation without making any changes to the
  1590. configuration information.
  1591.  
  1592. The [USE], [SAVE], [SAVE AS] or [CANCEL] buttons are active no matter
  1593. which configuration page is currently active.  When the Configuration
  1594. screen is first activated, the Identity page will be active.
  1595.  
  1596. Before exiting from the Configuration Screen with [USE], [SAVE], or [SAVE
  1597. AS] the required configuration parameters must be present.  If not, the
  1598. following requester will be displayed:
  1599.  
  1600.     The following Configuration items are empty
  1601.  
  1602.     [list of empty items]
  1603.  
  1604.     They are required items!
  1605.  
  1606. This is the same requester that is displayed when AEMail is started
  1607. without these parameters being provided.  Your choices with this requester
  1608. are:
  1609.  
  1610.     [Reenter Configuration Data]   [Cancel Configuration Request]
  1611.  
  1612. Clicking on the [Cancel Configuraion Request] will act the same as if you
  1613. clicked on [CANCEL] in the main configuration screen.  In this event your
  1614. "old" configuration data will still be active and if you did not have the
  1615. required parameters in the first place, you will not be able to do
  1616. anything but enter the data or exit from AEMail.
  1617.  
  1618. The one exception to the "old" configuration remaining the same is with
  1619. the .headers file.  This is always updated no matter which button is
  1620. pressed.
  1621.  
  1622.  
  1623.                               Identity Page
  1624.                               -------------
  1625.  
  1626. The Identity page appears as follows:
  1627.  
  1628. =========================================================================
  1629. AEMail Configuration Screen
  1630. -------------------------------------------------------------------------
  1631.  
  1632. [ IDENTITY ]____________________________________________________________
  1633. |                                                                       |
  1634. |         POP3 UserID: [               ][CLR][DEFAULT] [CHANGE PASSWORD]|
  1635. |                                                                       |
  1636. |From (email) Address: [                                 ][CLR][DEFAULT]|
  1637. |                                                                       |
  1638. |    Reply To Address: [                                 ][CLR]{DEFAULT]|
  1639. |                                                                       |
  1640. |           Real Name: [                                 ][CLR][DEFAULT]|
  1641. |                                                                       |
  1642. |        Organization: [                                 ][CLR][DEFAULT]|
  1643. |                                                                       |
  1644. |          POP Server: [                                 ][CLR][DEFAULT]|
  1645. |                                                                       |
  1646. |         SMTP Server: [                                 ][CLR][DEFAULT]|
  1647. |                                                                       |
  1648. |    SMTP Domain Name: [                                 ][CLR][DEFAULT]|
  1649. |_______________________________________________________________________|
  1650.  
  1651.                                           [USE] [SAVE] [SAVE AS] [CANCEL]
  1652.  
  1653.  
  1654. =========================================================================
  1655.  
  1656. When this page is first called up, values from the Tool Types or the
  1657. current configuration file (which ever takes precedence) will be displayed
  1658. in each of the string gadgets.
  1659.  
  1660. Appropriate information can be entered into each of the string gadgets. Up
  1661. to 99 characters can be entered in each of the string gadgets.
  1662.  
  1663. The buttons to the side of each string gadget perform the following
  1664. actions:
  1665.  
  1666.     [CLR] will cause the string gadget to be cleared.
  1667.  
  1668.     [DEFAULT] will cause default information to be loaded into the
  1669.         string gadgets as follows:
  1670.  
  1671.             POP3 UserID: information from the USERID= Tool Type.
  1672.             From Address: information from the FROM= Tool Type.
  1673.             Reply To Address: information from the REPLYTO=
  1674.                 Tool Type or, if missing, the From Address.
  1675.             Real Name: information from the REALNAME= Tool Type.
  1676.             Organization: information from the ORGANIZATION= Tool
  1677.                 Type.
  1678.             SMTP Domain Name: Information from the DOMAIN= Tool Type.
  1679.             POP Server: information from the POP_SERVER= Tool Type
  1680.                 if present; otherwise , if a Domain Name is present,
  1681.                 this will be the domain name with 'pop.' prepended
  1682.                 to it.
  1683.             SMTP Server:  Information from the SMTP_SERVER= Tool
  1684.                 Type if present; otherwise, if a Domain Name is
  1685.                 present, this will be the domain name with 'smtp.'
  1686.                 prepended to it.
  1687.  
  1688.         If a Tool Type was the only default and it is missing,
  1689.         nothing is loaded into the corresponding string gadget.
  1690.  
  1691. The [CHANGE PASSWORD] button gadget will bring up a special window which
  1692. will allow you to add or change your password.  This window looks like the
  1693. follwing:
  1694.  
  1695.                 |========================================|
  1696.                 |0|Enter Password                        |
  1697.                 |----------------------------------------|
  1698.                 |                                        |
  1699.                 |     Enter your new password below      |
  1700.                 |                                        |
  1701.                 |  [                                  ]  |
  1702.                 |                                        |
  1703.                 |                                        |
  1704.                 |                                        |
  1705.                 |  [START OVER]            [  CANCEL  ]  |
  1706.                 |________________________________________|
  1707.  
  1708.  
  1709. The string gadget will be automatically activated when the window is
  1710. displayed.  You can type in your new password, but for each character you
  1711. type, an '*' will appear.  After hitting return, the heading "Enter your
  1712. password below" will be replaced by the following heading:  "For
  1713. verification, re-enter your password".  You must re-enter your password
  1714. and, when you hit return, if the re-entered password matches the first
  1715. password, the password window will close.  The new password will not take
  1716. effect until you hit the [USE], [SAVE] or [SAVE TO] buttons at the bottom
  1717. of the Configuration screen.  If you hit the [CANCEL] button at the bottom
  1718. of the Configuration screen even though the new password has been
  1719. accepted, the new password will not be used.
  1720.  
  1721. If the re-entered password does not match, the following will appear below
  1722. the password entry string gadget:
  1723.  
  1724.                        Password failed Validation!
  1725.  
  1726. and the "Enter your password below" heading will re-appear.
  1727.  
  1728. If at any time you want to start over with entering the new password, you
  1729. can click on the [START OVER] gadget.  If you want to cancel the password
  1730. entry process you can either click on the close gadget at the top left of
  1731. the window or on the [CANCEL] gadget in the window.
  1732.  
  1733. Only 30 characters can be entered into the password string gadget.
  1734.  
  1735.  
  1736.                                TCP/IP Page
  1737.                                -----------
  1738.  
  1739. The TCP/IP page appears as follows:
  1740.  
  1741. ==========================================================================
  1742. AEMail Configuration Screen
  1743. --------------------------------------------------------------------------
  1744.  
  1745.  ____________[  TCP/IP  ]________________________________________________
  1746. |                                                                        |
  1747. |Start Net Call: [                                   ][REQ][CLR][DEFAULT]|
  1748. |                [ ] Start Net Opens on the Workbench                    |
  1749. |                                                                        |
  1750. | Stop Net Call: [                                   ][REQ][CLR][DEFAULT]|
  1751. |                [ ] Stop Net Opens on the Workbench                     |
  1752. |                                                                        |
  1753. | [ ] Automatic connection to Internet Provider on AEMail Start Up       |
  1754. | [ ] Display disconnect check on AEMail exit                            |
  1755. |                                                                        |
  1756. |Disable Queued Mail Chk [] on connection establishment [] at AEMail exit|
  1757. |   Disable New Mail Chk [] on connection establishment [] at AEMail exit|
  1758. |                                                                        |
  1759. |                  Check for new mail every [  ] minutes                 |
  1760. |________________________________________________________________________|
  1761.  
  1762.                                           [USE] [SAVE] [SAVE AS] [CANCEL]
  1763.  
  1764.  
  1765. ==========================================================================
  1766.  
  1767. The "Start Net Call" and "Stop Net Call" are required if you are going to
  1768. start up or stop your TCP/IP connection from within AEMail with a script.
  1769. If you are using AmiTCP, this is normally either the file "startnet" or
  1770. "stopnet" in the AMITCP:bin directory.  If you are using Miami, two AREXX
  1771. scripts, called "startnet.miami" and "stopnet.miami" have been provided
  1772. with the AEMail archive located in the AEMail program directory.
  1773.  
  1774. When first presented, these two string gadgets will contain the values
  1775. given in you STARTNET and STOPNET Tool Types or what was last stored in
  1776. your configuration file.  If these two Tool types are not present, these
  1777. two string gadgets will be blank unless a previous configuration file is
  1778. present and has these calls.
  1779.  
  1780. If you do not want what is presented as the default in these two string
  1781. gadgets, you can enter the correct path and script name in the string
  1782. gadgets.  A full path name to that script must be entered.  If the script
  1783. is an AREXX script it should be preceded with "rx " (a space is between
  1784. the rx and the script name).  The standard AmiTCP startnet script is NOT
  1785. an AREXX script even though it uses AREXX commands.  It is an AmigaDOS
  1786. script.  The Miami script which comes with AEMail, on the other hand, is
  1787. an AREXX script.
  1788.  
  1789. The [REQ] button will call up a file requester to allow you the find the
  1790. script you want and [CLR] will clear the string gadget.
  1791.  
  1792. [DEFAULT] will place the script path and name from your Tool Types in the
  1793. appropriate string gadget.
  1794.  
  1795. If you need the "Start Net" script or the "Stop Net" script to open on the
  1796. workbench screen, click on the approriate check mark gadget for the
  1797. particular script.  When the TCP/IP Configuration page first opens the
  1798. "Start Net Opens on the Workbench" item will be checkmarked.
  1799.  
  1800. SPECIAL NOTE FOR USERS OF TERMITE TCP:
  1801.  
  1802. If you are using a TCP/IP stack that does not have a Start Net or Stop Net
  1803. script (such as TermiteTCP), you should use the [CLR] button to clear
  1804. these two string gadgets.  Starting and stopping your Internet connection
  1805. is then done manually.  Then when you use the Start Net or Stop Net menu
  1806. item, the action that is performed is to iconify AEMail.  You can then
  1807. perform the network connection in what ever manner was provided by your
  1808. TCP/IP stack software.  Once the connection is made, un-iconify AEMail and
  1809. AEMail will then check your POP Server for any available messages if that
  1810. option was selected (see below).
  1811.  
  1812. The "Automatic connection to Internet Provider on AEMail Start Up" check
  1813. box provides the same capability as the AUTOCONNECT Tool Type.  When
  1814. AEMail is first activated it attempts to determine if you are connected to
  1815. your Internet provider.  If you are not and this item is checked, AEMail
  1816. will automatically run your StartNet script.  However, the AUTOCONNECT
  1817. function will be disabled if you do not have a "Start Net" script.
  1818.  
  1819. Except when you are using AEMail as a mailto:  agent, when AEMail
  1820. terminates and you are still connected to your Internet provider, the
  1821. following Requester will be displayed:
  1822.  
  1823.             Do you wish to terminate your Host connection now?
  1824.  
  1825. You will given the opportunity to reply with either a [YES] or [NO].  If
  1826. you never want you Internet connection to be terminated when you exit from
  1827. AEMail, you can prevent the above requester from being displayed by NOT
  1828. checking the "Display disconnect check on AEMail exit" box.  By default,
  1829. this box WILL BE CHECKED, so, to disable the function, you would have to
  1830. click in this box.  However, this function will automatically be disabled
  1831. if you do not have a Stop Net script.
  1832.  
  1833. Please Note:  The way AEMail determines if you are still connected is to
  1834. check if the "bdsocket.library" is present.  This library may become
  1835. present when you load your TCP/IP stack software.  Even though you may not
  1836. be connected the bdsocket.library will then be present, so you will get
  1837. the above notification even though you are not actually connected.  In
  1838. this event replying with either [YES] or [NO] to the requester will have
  1839. no effect.
  1840.  
  1841. Whenever AEMail is first loaded and is connected to Internet Provider or
  1842. if you select "Start Net" from the "TCP/IP" menu, a check will be made for
  1843. any mail on your POP server or any mail that must be sent from your QUEUED
  1844. folder.  Except when you are using AEMail as a "mailto:" agent, this same
  1845. check is also performed when you quit AEMail.  You can disable any of
  1846. these checks by checking the appropriate box in the following lines:
  1847.  
  1848. Disable Queued Mail Chk [] on connection establishment [] at AEMail exit
  1849. Disable New Mail Chk [] on connection establishment [] at AEMail exit
  1850.  
  1851. AEMail also has the capability for checking for mail periodically on your
  1852. POP server.  This function is performed in the background so you can be
  1853. doing other activities while this check is going on.  When mail is found,
  1854. the following requester will pop up on your screen:
  1855.  
  1856.  
  1857.                              YOU HAVE MAIL!!
  1858.  
  1859.                   n Messages available on the POP Server
  1860.  
  1861.                 Do you wish to receive these messages now?
  1862.  
  1863.  
  1864. Replying [YES] to the above requester will start the retrieval of the
  1865. messages.  If you are in iconify mode when this occurs, the retrieval will
  1866. occur in the background without bringing up the AEMail screen.
  1867.  
  1868. You can set the time interval for this check by entering the appropriate
  1869. number of minutes in the following numeric gadget:
  1870.  
  1871.                   Check for new mail every [  ] minutes
  1872.  
  1873. The default time interval is 2 minutes.  If you enter a zero in this
  1874. numeric gadget, no check will be made.
  1875.  
  1876.  
  1877.                             Default Path Page
  1878.                             -----------------
  1879.  
  1880.  
  1881. The Default Path page appears as follows:
  1882.  
  1883. ==========================================================================
  1884. AEMail Configuration Screen
  1885. --------------------------------------------------------------------------
  1886.  
  1887.  ________________________[  PATHS  ]_____________________________________
  1888. |                                                                        |
  1889. |             Mailcap Directory: [                   ][REQ][CLR][DEFAULT]|
  1890. |                                                                        |
  1891. |              TCP Logging File: [                   ][REQ][CLR][DEFAULT]|
  1892. |                                [ ] TCP Logging Active on AEMail startup|
  1893. |                                                                        |
  1894. |  Retrieve Mail from Directory: [                   ][REQ][CLR][DEFAULT]|
  1895. |                                                                        |
  1896. |        Save Mail to Directory: [                   ][REQ][CLR][DEFAULT]|
  1897. |                                                                        |
  1898. |Add Attachments from Directory: [                   ][REQ][CLR][DEFAULT]|
  1899. |                                                                        |
  1900. | Save Attachments to Directory: [                   ][REQ][CLR][DEFAULT]|
  1901. |________________________________________________________________________|
  1902.  
  1903.                                            [USE] [SAVE] [SAVE AS] [CANCEL]
  1904.  
  1905.  
  1906. ==========================================================================
  1907.  
  1908. String gadgets are provided for giving the full path for each of the
  1909. default directories and or file.  The directory paths that can be
  1910. specified are:
  1911.  
  1912.     Mailcap Directory: This is the directory that contains your
  1913.         mailcap file.  The file will always be named "mailcap".
  1914.         The default entry for this is "AEMAIL:".
  1915.  
  1916.     TCP Logging File:  This allows you to enter a file name as well
  1917.         as a path.  The default path and file name is "tcplog" in
  1918.         the AEMail program directory.  If this field is cleared, no
  1919.         TCP logging can take place.  When the [SAVE], [SAVE AS] or
  1920.         [USE] gadgets are selected, if TCP Logging was active and
  1921.         the TCP logging File name that was entered is different
  1922.         from the current log file, the current log file will be
  1923.         closed and a new file opened.  If you clear this field
  1924.         TCP logging will stop since there is no file to log to.
  1925.  
  1926.         Whether logging takes place or not should depend on the
  1927.         "TCP/IP/TCP Logging File/Active" menu item (checkmarked
  1928.         flag).
  1929.  
  1930.         You can cause TCP logging to be active when AEMail starts
  1931.         up by checking the "TCP Logging Active on AEMail startup"
  1932.         check mark gadget below the TCP Logging File string gadget.
  1933.         If this item is checked, the logging will become active
  1934.         when you exit from the Configuration screen.  You will have
  1935.         to turn off the Active flag in the "TCP/IP/TCP Logging File"
  1936.         menu item to stop logging.
  1937.  
  1938.         Note: none of the actions mentioned above will take place
  1939.         until you select [USE], [SAVE] or [SAVE TO] at the bottom
  1940.         of the Configuration screen.  If you select [CANCEL] no
  1941.         change will be made in your TCP logging activity.
  1942.  
  1943.     Retrieve Mail from Directory:  This is the initial path that will
  1944.         appear in the file requester when you Retrieve mail from a
  1945.         file rather than your POP Server.  The default directory for
  1946.         these files is "PROGDIR:" which is your current AEMail program
  1947.         directory.  If you regularly are trying to bring in mail that
  1948.         was previously transferred using another mail user agent such
  1949.         as AmiPOP, AirMail, or Voodoo, you should use the directory
  1950.         that was used for these agents for storing mail.  You can
  1951.         specify any directory of your choosing as the default path
  1952.         for the Retrieve Mail file requester.  You enter that
  1953.         default in this string gadget.
  1954.  
  1955.     Save Mail to Directory:  This is the initial path that will appear
  1956.         in the file requester when you select the "Save Mail" icon
  1957.         in the command icon strip.  The default directory for this
  1958.         path is PROGDIR:, which is your current program directory.
  1959.         However, you can specify any other path of your choosing as
  1960.         the default path for the Save Mail file requester.  You enter
  1961.         that default in this string gadget.
  1962.  
  1963.     Add Attachments from Directory:  This is the initial path that will
  1964.         appear in the file requester when you select the [REQ] button
  1965.         in the Add Attachment requester (see below under Section VIII.
  1966.         AEMail WINDOWS.  The default directory for this path is PROGDIR:.
  1967.         However, you can specify any other path of your choosing as
  1968.         the default path for the Add Attachment requester.  You enter
  1969.         that default in this string gadget.
  1970.  
  1971.     Save Attachments to Directory:  This is the initial path that will
  1972.         appear in the file requester when you select the [Save] or
  1973.         [View & Save] buttons in the Attachment requester (see below
  1974.         under Section VIII. AEMail WINDOW.  The default directory for
  1975.         this path is RAM:.  However, you can specify any other path of
  1976.         your choosing as the default path for the Attachment file
  1977.         requester.  You enter that default in this string gadget.
  1978.  
  1979. When this this page is first activated, the values that were last saved in
  1980. the current configuration file will be displayed.
  1981.  
  1982. The buttons to the side of each string gadget perform the following
  1983. actions:
  1984.  
  1985.     [CLR] will cause the string gadget to be cleared.
  1986.  
  1987.     [DEFAULT] will cause default information, as described above, to be
  1988.         loaded into the appropriate string gadget.
  1989.  
  1990.     [REQ] causes a file requester to appear for selecting the appropriate
  1991.         directory and file name (TCP Logging File only) to be loaded
  1992.         into the appropriate string gadget.  The file requester will
  1993.         start out with the last path that was used for that particular
  1994.         string gadget.  If no path was last used, a dummy name of
  1995.         "VOLUMES" will be used, the requester will flash, and the
  1996.         volumes and assigns will be displayed.
  1997.  
  1998.  
  1999.  
  2000.                          General Parameters Page
  2001.                          -----------------------
  2002.  
  2003.  
  2004. The General Parameters page appears as follows:
  2005.  
  2006. ==========================================================================
  2007. AEMail Configuration Screen
  2008. --------------------------------------------------------------------------
  2009.  
  2010.  ___________________________________[ GENERAL ]__________________________
  2011. |                                                                        |
  2012. |Printer Device: [PRT:            ][REQ][CLR][DEFAULT]   Top Margin:[4  ]|
  2013. |                [ ] Include Attachment List in Print Out                |
  2014. |                                                                        |
  2015. |       [ Printer Setup ]                           [Set Screen Mode]    |
  2016. |                           [Set Minimum Headers]                        |
  2017. |                                                                        |
  2018. |           [ ] Delete Mail from Server     [ ] Display Full Header      |
  2019. |           [ ] Strip Duplicate Messages    [ ] Include Header in Reply  |
  2020. |                                                                        |
  2021. |     EditCall: [                                 ][REQ][CLR][DEFAULT]   |
  2022. |               [ ] Editor Opens on the Workbench                        |
  2023. |                                                                        |
  2024. |                   Default Reply to Message Parameters                  |
  2025. |                                                                        |
  2026. |           [ ] Quote Original Message Text   Quote Prefix[>         ]   |
  2027. |                                                                        |
  2028. |           Quote Header: [                                          ]   |
  2029. |________________________________________________________________________|
  2030.  
  2031.                                            [USE] [SAVE] [SAVE AS] [CANCEL]
  2032.  
  2033.  
  2034. ==========================================================================
  2035.  
  2036. The General Parameter page allows you to set up certain general type
  2037. parameters such as specifications for your printer device, your screen
  2038. mode that you want your AEMail screen to open on, the list of minimum
  2039. headers you want displayed in a message, certain default menu checkmarked
  2040. items, the specification for your editor, and the specifications for the
  2041. default message reply headers.
  2042.  
  2043. For the Printer Device you can specify the device that you want to do your
  2044. printing on.  By default this is PRT:, but you can specify a file if you
  2045. care to.  If you specify a file, your printer output will be sent as
  2046. standard ASCII text with form feeds and margin spacing included in the
  2047. output.  The [REQ] button will call up a file requester through which you
  2048. can enter the path and file name of this printer file.  [CLR] will clear
  2049. the string gadget and DEFAULT will enter PRT:  into the gadget.  When this
  2050. page is first displayed, the PRT:  default will be in the gadget.
  2051.  
  2052. You can also specify the Top Margin of the printout with the numeric
  2053. string gadget to the right of the Printer Device.  The default top margin
  2054. is 4.
  2055.  
  2056. If you want the list of attachments to appear on the last page of your
  2057. printout, you can check the "Include Attachment List in Print Out" box.
  2058. By default, this box is checked when you first call up the General
  2059. Parameters page.
  2060.  
  2061. If you want to modify your printer setup parameters that are normally set
  2062. with your PRINTER PREFERENCES, you can click on the [Printer Setup]
  2063. button.  This will call up the standard Printer Preferences program so
  2064. that you can change your printer setup.  Please Note that, if you change
  2065. the printer preferences, the new preferences will remain in effect when
  2066. you quit AEMail.
  2067.  
  2068. If you want to set your screen mode for AEMail, you can click on the [Set
  2069. Screen Mode] button.  This will call up a Screen Mode Requester which will
  2070. allow you to set whatever screen mode you wish.  Your overscan mode can
  2071. also be set.  This defaults to "OVERSCAN-TEXT".  When you save your
  2072. configuration settings, the screen mode you selected and the overscan
  2073. setting are saved in the AEMail configuration file and will be used the
  2074. next time you load AEMail.
  2075.  
  2076. The minimum header set that you want displayed in your message can be set
  2077. by clicking on the [Set Minimum Headers] button.  This will bring up a
  2078. requester that looks like this:
  2079.  
  2080.                    |==================================|
  2081.                    |[o]  Set Minimum Headers          |
  2082.                    |==================================|
  2083.                    |      Select/Deselect Headers     |
  2084.                    |          to be displayed         |
  2085.                    |==================================|
  2086.                    || *bcc:                        | ||
  2087.                    || *cc:                         | ||
  2088.                    ||  Content-Transfer-Encoding:  | ||
  2089.                    ||  Content-Type:               | ||
  2090.                    || *Date:                       | ||
  2091.                    || *From:                       | ||
  2092.                    |==================================|
  2093.                    |         Enter New Header         |
  2094.                    |[                                ]|
  2095.                    |                                  |
  2096.                    |              [OK]                |
  2097.                    |==================================|
  2098.  
  2099. A list of possible message headers is displayed in the scrollable list.
  2100. An asterick (*) in front of a header indicates that it has been selected
  2101. for inclusion in the minimum header list.  Clicking on an item in the list
  2102. will select it with an (*).  If it is already selected, it will be
  2103. deselected (the asterick will change to a blank).
  2104.  
  2105. The string gadget at the bottom of the requester is used to enter a header
  2106. that is not in the list.  Be sure and end the header with a colon (:).
  2107. After entering the header, press return and the header will be placed
  2108. properly in the scollable list.  It will be deselected when it is first
  2109. entered in the list.  You will have to click on it to select it.
  2110.  
  2111. When you are through entering items in the list, click on [OK] and you
  2112. will be returned to the General Parameters page.  Clicking on the close
  2113. gadget at to top of the requester has the same effect as clicking on [OK].
  2114.  
  2115. Please NOTE:  anything you enter in the list or select/deselect will
  2116. remain in the list in that state during the current run of AEMail even if
  2117. you click on [CANCEL] in the main configuration window.  In other words,
  2118. [CANCEL] for the minimum header list has the same effect as [USE].
  2119. Clicking on [SAVE] or [SAVE AS] at the bottom of the screen will
  2120. permanently save the headers you have selected.
  2121.  
  2122. There is no way to delete a header once it has been entered in the list
  2123. and saved except by deleting the .headers file in the AEMAIL:  directory.
  2124. This is really not a problem, however, since, if you entered an incorrect
  2125. header and haven't selected it, it will have no effect on the program.
  2126.  
  2127. The four check boxes:
  2128.  
  2129.     [ ] Delete Mail from Server
  2130.     [ ] Display Full Header
  2131.     [ ] Strip Duplicate Messages
  2132.     [ ] Include Header in Reply
  2133.  
  2134. have the same effect as the Tool Types DELETEMAIL=, FULLHEADER=,
  2135. STRIPDUPS=, and HDRINREPLY=.  A checked condition is the same as a YES in
  2136. the Tool Type.  When you exit from the Configuration screen with either
  2137. [USE], [SAVE] or [SAVE AS], the corresponding menu items will be checked
  2138. or unchecked depending on the state of these check boxes.
  2139.  
  2140. For the EditCall string gadget you must use the full path name of the
  2141. editor of your choice plus any parameters you want to use on the call.  To
  2142. specify where the file name you are editing goes use '%s'.  An example
  2143. would be:
  2144.  
  2145.     c:ed %s
  2146.  
  2147. Below the EditCall:  string gadget is a checkmark gadget which is used to
  2148. tell AEMail that your editor will open on the Workbench screen.  If your
  2149. editor of choice does not open on it's own screen, you must check this
  2150. item.  The AmigaDos editor, ED, does NOT open on it's own screen; therefor
  2151. you must check this item if you are using ED.
  2152.  
  2153. The DEFAULT for the EditCall is the information from the EDITOR Tool Type.
  2154. If the key word 'WB;' precedes the editor call information in the tool
  2155. type, the "Editor Opens on Workbench" item will be checkmarked.  'WB;'
  2156. will NOT appear in the EditCall string gadget.
  2157.  
  2158. If the EDITOR Tool Type was not provided, the following will be the
  2159. default EditCall:
  2160.  
  2161.     c:ed %s
  2162.  
  2163. and the "Editor Opens on Workbench" item will be checkmarked.  This
  2164. uses the default AmigaDos editor, ed.
  2165.  
  2166. If you need to find where your editor is located, [REQ] causes a file
  2167. requester to appear for selecting the appropriater program file to be
  2168. loaded into the EditCall string gadget.
  2169.  
  2170. The section below the heading "Default Reply to Message Parameters" is
  2171. used to set up the default actions when you are replying to a message.
  2172. The "Quote Original Message Text" box sets up the default action for
  2173. quoting the original text in a message.  Even though you take the default
  2174. of not quoting text, you will be given an opportunity to change you mind
  2175. about this when you compose the message.
  2176.  
  2177. The "Quote Prefix:" string gadget indicates what is to be placed in front
  2178. of each quoted line if an original message is quoted.  This, by default,
  2179. is '>'; however, you can use any other prefix as the derfault that you
  2180. like.
  2181.  
  2182. A "Quote header:" will be placed on the line in front of the quoted
  2183. material.  You can choose what you would like as the default heading and
  2184. enter it in this string gadget.  By default, the header which will
  2185. initially appear in the "Quote Header:" string gadget is:
  2186.  
  2187.     On &(week), &(date2), at &(time), &(name) wrote:
  2188.  
  2189. The & followed by a field name in parenthesis indicates substitution of
  2190. data from the original message's headers.  The values that can be
  2191. substituted are:
  2192.  
  2193.     &(name)     The real name of the sender of the original
  2194.                 message.  If the real name is not available,
  2195.                 the sender's email address will be used instead
  2196.  
  2197.     &(subject)  The subject from the original message.  Any RE:
  2198.                 or (fwd) will be stripped.
  2199.  
  2200.     &(week)     The day of the week that the original message
  2201.                 was sent.
  2202.  
  2203.     &(date)     The date the original message was sent in the form
  2204.                 DD MMM YYYY, where DD is the day of the month,
  2205.                 MMM is month in the form Jan, Feb, Mar, etc, and
  2206.                 YYYY is the full 4 digit year.
  2207.  
  2208.     &(date1)    Same as &(date).
  2209.  
  2210.     &(date2)    The date in the form MMM DD, YYYY.
  2211.  
  2212.     &(time)     The time the original message was sent in the
  2213.                 form HH:MM xM where HH is the hour on a 12 hour
  2214.                 clock, MM is the minute, and xM is AM or PM.
  2215.  
  2216.     &(to)       The email address the message was sent to.  For
  2217.                 mailing lists this could be the name of the mailing
  2218.                 list if that is what appeared in the To: header.
  2219.  
  2220. The "Quote Header" is designed to be modified by the user and can be
  2221. changed with this string gadget.  This is a permanent change if you select
  2222. [SAVE] to save the Configuration data or it can be in effect as the
  2223. default for only this running of AEMail if you select [USE].  You can
  2224. always change this default, however, when you compose a message.
  2225.  
  2226.                              V. USING AEMAIL
  2227.  
  2228.                              Starting AEMail
  2229.                              ---------------
  2230.  
  2231. AEMail can be started either from the Workbench by double clicking on it's
  2232. icon or from the shell.  It is recommended that AEMail be normally run
  2233. from the Workbench.  The shell invocation is primarily designed for
  2234. "MailTo" agents in WWW browsers or to call AEMail from another program
  2235. that passes a message to it.
  2236.  
  2237.                       Starting AEMail from the Shell
  2238.                       ------------------------------
  2239.  
  2240. When AEMail is invoked from the shell, there are six optional argument
  2241. that can be used as follows:
  2242.  
  2243.  AEMail [email-addr-of-recipient-of-email] [config=configuration_file]
  2244.    [pubscr=browser-screen-name] [mail_dir=full-path-to-mail-directory]
  2245.    [message=full-path-name-of-message-to-send] [CONT]
  2246.  
  2247. If either the recipient's email address is present or the "message="
  2248. argument is present, AEMail assumes that we are using AEMail as a "MailTo"
  2249. agent or you are trying to queue or send a message composed outside of
  2250. AEMail.  AEMail will load and immediately display the Compose message
  2251. window.
  2252.  
  2253. If the "message=" argument was used, you will be in the "edit" mode of the
  2254. compose screen.  You can either edit the supplied message or immediately
  2255. [Save in Pending], [Queue Message], [Send Message Now], or [Cancel
  2256. Message].  You can also perform any other action on the message including
  2257. adding headers, adding attachments, or adding your signature block (see
  2258. the Section VIII, Compose Message Window).
  2259.  
  2260. The message that the "message=" argument points to must be a complete
  2261. message with at least one header.  It is suggested that you include at
  2262. least a "To:  " and "Subject:  " header.  These should be followed with at
  2263. least one blank line before the body of the message.
  2264.  
  2265. If both the "mail address of the recipient" argument and the "message="
  2266. argument are used, the "mail address" will take precedence over the "To: "
  2267. header in the message.
  2268.  
  2269. The recipient's name in either the mailto argument or the To header in the
  2270. message referenced by the "message=" argument, can be a nickname present
  2271. in your Address Book.  This is a convenient way to send messages to groups
  2272. where you are periodically adding or deleting members from the group.
  2273. Just use the group nickname in the "To:  " address to send the message to
  2274. the entire group.
  2275.  
  2276. If the "message=" argument is not present but a recipient's email address
  2277. is present, you will enter the compose window in a "new" message mode.
  2278. You must compose a message or Cancel the operation in order to procede.
  2279.  
  2280. When you exit from the Compose window by clicking on one of the action
  2281. requesters at the bottom of the window, AEMail will terminate
  2282. automatically unless the "CONT" keyword was present in the argument
  2283. stream.  If "CONT" is used, AEMail will continue so that you can perform
  2284. other AEMail functions.  You will then have to quit using the "Quit..."
  2285. menu item in the "Project Menu".
  2286.  
  2287. The "config=" keyword parameter is used to specify a configuration file
  2288. other that the normal s:aemail.cnfg file.  All pertanent data on the
  2289. AEMail configuration to be used will be in this file.  If you wish to
  2290. invoke AEMail from the shell and have it run normally (not as a "MailTo"
  2291. agent), you can use the "config=" parameter to direct AEMail to use a
  2292. different configuration file on startup.  To use AEMail in this manner,
  2293. you could simply type:
  2294.  
  2295.     AEMAIL config=[name_of_configuration_file]
  2296.  
  2297. The "mail_dir=" is used to override the AEMAIL:  assignment for the mail
  2298. directory.  You must specify a full path name for this alternate mail
  2299. directory.
  2300.  
  2301. If AEMail is used as a "mailto:" agent for your browser and that browser
  2302. passes it's public screen name along with the userid, you can use the
  2303. keyword argument "pubscn=" to specify that public screen.  AEMail will
  2304. then bring the browser's screen to the front when AEMail terminates.  If
  2305. this argument is missing and the browser opens on it's own screen but does
  2306. not, itself, bring the screen to the front when it returns from the
  2307. "mailto" command, you might have to manually bring the browser's screen to
  2308. the front with the LEFT-AMIGA M key.
  2309.  
  2310. When you invoke AEMail from the shell with a email address parameter or a
  2311. "message=" argument, you normally will not be able to use any of the
  2312. AEMail menus or commands unless the "CONT" key word was used.  However,
  2313. AEMail will always check for Mail on your POP Server and for Queued
  2314. messages to send before displaying the Compose message screen (see initial
  2315. AEMail action below) and ask for configuration data if required parameters
  2316. are not present in the s:aemail.cnfg file or the config= configuration
  2317. file.
  2318.  
  2319. If you invoked AEMail from the shell without any parameters, AEMail will
  2320. behave the same as if it was invoked from the Workbench by clicking on
  2321. it's icon except that tool types will not be utilized.  That action is
  2322. described below.
  2323.  
  2324. AEMail can be run either in an offline or online mode.  This means that
  2325. you do not have to be connected to your Internet provider when AEMail is
  2326. activated.  However, to actually receive or send mail via your Internet
  2327. provider, you must have your TCP/IP stack (AmiTCP, TermiteTCP, Miami, etc)
  2328. running and connected to your provider.  You can activate AEMail before
  2329. connecting to your provider or after; it makes no difference.
  2330.  
  2331. Both a convenient menu item and a command icon have been provided in
  2332. AEMail to start your TCP/IP stack ("TCP/IP/Start Net") after AEMail is up
  2333. and running provided a script can be used to make this connection.  If
  2334. a script is not provided for this purpose, AEMail will iconify to allow
  2335. you to start your TCP/IP stack manually.  A menu item ("TCP/IP/Stop Net")
  2336. and command icon have also been provided to disconnect your network
  2337. connection.
  2338.  
  2339. You can also automatically activate your TCP/IP stack at program startup
  2340. by providing the AUTOCONNECT=YES Tool Type described above or by check
  2341. marking the "Automatic connection to Internet Provider on AEMail Start Up"
  2342. in the TCP/IP Page of the configuration screen.  WARNING:  for this to
  2343. work, you will need to be able to activate your TCP/IP stack automatically
  2344. by a script.
  2345.  
  2346.                    Activating AEMail from the Workbench
  2347.                    ------------------------------------
  2348.  
  2349. To activate AEMail from the Workbench simply double click on the AEMail
  2350. icon.  You can also activate AEMail from the shell, but, if activated in
  2351. this manner, it will not have access to the configuration information
  2352. provided by Tool Types.  It does, however, have access to the
  2353. configuration information in the specified AEMail configuration file
  2354. (either s:aemail.cnfg or the file specified with config= in the shell
  2355. calling argument).
  2356.  
  2357. AEMail opens on it's own 16 color Public Screen.  The Public Screen name
  2358. is "AEMAIL-1".  4 of the colors are defined by the first four colors of
  2359. the workbench screen.  The following 8 colors are pre-defined with the
  2360. following colors:  Red (13R, 0B, 0G), Green (0R, 15G, 0B), Blue (0R, 0G,
  2361. 15B), Magenta (15R, 0G, 15B), Yellow (15R, 15G, 0B), Orange (15R, 10G,
  2362. 0B), Brown (10R, 5G, 0B), and Purple (9R, 3G, 9B).  These colors have been
  2363. preset to provide a consistant color scheme for displaying icons and
  2364. folder tab colors.  Under consideration is the possibility of allowing
  2365. these colors to be user settable in the future.
  2366.  
  2367. Since multiple windows are opened by AEMail, the program opens on it's own
  2368. screen to allow uniformity in being able to push the screen to the back
  2369. (with all of it's member windows) and back again to the front.  The
  2370. LEFT-AMIGA-M key can be used for this purpose.
  2371.  
  2372. You can also iconify AEMail with an iconify bar on the Workbench screen.
  2373. A menu item has been provided to perform the iconify action.  When this
  2374. menu item is selected, the AEMail screen will disappear and a button bar
  2375. will appear on the Workbench screen with
  2376.  
  2377.     AEMail (Click on Close or with RMB to restore)
  2378.  
  2379. in the title.  When the iconified bar is selected, clicking either on the
  2380. close gadget or with the Right Mouse Button (RMB) will restore the AEMail
  2381. screen.
  2382.  
  2383. There is also a hotkey provided for iconifying AEMail.  This is
  2384. RIGHT-AMIGA-I.  This same hot key will also take AEMail out of iconify
  2385. mode.  The LEFT-AMIGA-I key will also accomplish this.
  2386.  
  2387. Periodically during the running of AEMail, the program will automatically
  2388. switch to the workbench screen for executing certain functions and then
  2389. switch back when the function is complete.
  2390.  
  2391. The first thing AEMail does when it is activated is to check to see that
  2392. certain configuration information has been provided.  The necessary items
  2393. are:
  2394.  
  2395.     POP3 UserID
  2396.     Password
  2397.     Your email address
  2398.     SMTP Domain Name
  2399.     Edit Call
  2400.  
  2401. If these items have not be provided, the following requester will be
  2402. displayed:
  2403.  
  2404.     The following Configuration items are empty
  2405.  
  2406.     [list of empty items]
  2407.  
  2408.     They are required items!
  2409.  
  2410. The Pop Server call and the SMTP Server call will also be included in this
  2411. list if the Domain Name is missing.
  2412.  
  2413. If this requester is displayed, you will be given the following choices:
  2414.  
  2415.            [Configure AEMAIL now]               [Cancel AEMAIL]
  2416.  
  2417. If you were to click on [Cancel AEMAIL], AEMail will terminate.  You can
  2418. not proceed any further until you have entered these items with the
  2419. Configuration screen or by providing them as Tool Types.
  2420.  
  2421. Clicking on the [Configure AEMAIL now] will bring up the Configuration
  2422. screen which was described previously.
  2423.  
  2424. If the PASSPROTECT=YES Tool Type was provided (registered users only) the
  2425. following window will be displayed:
  2426.  
  2427.                 |========================================|
  2428.                 |0|Enter Password                        |
  2429.                 |----------------------------------------|
  2430.                 |                                        |
  2431.                 |     Enter your new password below      |
  2432.                 |                                        |
  2433.                 |  [                                  ]  |
  2434.                 |                                        |
  2435.                 |                                        |
  2436.                 |                                        |
  2437.                 |  [START OVER]            [  CANCEL  ]  |
  2438.                 |________________________________________|
  2439.  
  2440.  
  2441. You must enter your password before you can procede.  You will be allowed
  2442. three attempts to enter a correct password.  If the correct password has
  2443. not been entered after three attempts, AEMail will terminate.  If the
  2444. password is correct, AEMail will continue.
  2445.  
  2446. NOTE: since activating the password protection is done by a Tool Type,
  2447. password protection is not available when you activate AEMail from the
  2448. shell.  A later version will allow you to set this option with the
  2449. configuration screens, but currently this feature is only available as a
  2450. Tool Type.
  2451.  
  2452. After verifying that required configuration information has been provided
  2453. and that correct password has been entered (if required), AEMail will
  2454. check to see if you are connected to your Internet provider.  If it is,
  2455. connection will be made to your POP server to see if there are any
  2456. messages available on the server in your mail box.  If there are, the
  2457. following requester will appear:
  2458.  
  2459.                   n Messages Available on the POP Server
  2460.  
  2461.                 Do you wish to receive these messages now?
  2462.  
  2463. If you click on the [YES] button, those message will be retrieved at this
  2464. point.  See the RETRIEVE MESSAGES command described in Section VI.
  2465. COMMAND ICON STRIP for details on this process.
  2466.  
  2467. If you click on [NO], no message retrieval will take place at this time.
  2468. You will need to retrieve these messages later using the RETRIEVE MESSAGES
  2469. command icon.
  2470.  
  2471. After AEMail checks to see if any messages are available on the POP
  2472. Server, it also checks to see if any messages are in the QUEUED folder
  2473. (messages queued to be sent).  If there are, the following requester will
  2474. appear:
  2475.  
  2476.                   You have n messages queued to be sent
  2477.  
  2478.                  Do you wish to send these messages now?
  2479.  
  2480. If you click on the [YES] button, all of the messages in the QUEUED folder
  2481. will be sent immediately.  This is the same as selecting the "Send Queued
  2482. Mail" item under the "Project" menu or selecting the QUEUED FOLDER and
  2483. clicking on the "Send Message Immediately" command icon (see Sections VI.
  2484. Command Icon Strip and VII.  AEMAIL MENUS below).
  2485.  
  2486. If you click on [NO], the queued messages will not be sent at this time.
  2487. You will need to send these messages later using either the "Send Queued
  2488. Mail" item under the "Project" menu or selecting the QUEUED FOLDER and
  2489. clicking on the "Send Message Immediately" command icon.
  2490.  
  2491. If you successfully connected at program startup the following message
  2492. will appear in the Title bar of the AEMail screen:
  2493.  
  2494.     TCP/IP session started with [Your-POP-Server-Name]
  2495.  
  2496. If you were not connected the following message will appear in the Title
  2497. bar:
  2498.  
  2499.     Not Connected to [Your-POP-Server-Name] Host
  2500.  
  2501. You can disable either or both the POP mail check or the queued mail check
  2502. at startup by checkmarking the appropriate items in the TCP/IP Page of the
  2503. Configuration screen.
  2504.  
  2505. When AEMail first starts, three windows are opened in horizontal bands on
  2506. the AEMail screen.  A window is displayed just below the screen menu/title
  2507. bar and provides a contextual help title bar and a Command Icon Tool Bar.
  2508. This Tool Bar provides icons for accessing the major functions of AEMail
  2509. and consists (from left to right) of the following icons:  Display Folder
  2510. List, Display Address Book, Retrieve Messages, Display Previous Message,
  2511. Display Previous Folder's Message List, Display Current Folder's Message
  2512. List, Display Next Folder's Message List, Display Next Message, Compose a
  2513. Message, Queue Message for Later Delivery, Send Message Immediately, Save
  2514. Message To File, Print, Delete/Undelete Message, Copy Messages, Transfer
  2515. Messages, Start TCP/IP Network Connection and Terminate TCP/IP Network
  2516. Connection.
  2517.  
  2518. The window below the command icon tool bar contains a "folder strip" set
  2519. of icons.  An icon is provided for each folder with a colored "tab" to
  2520. indicate the type of folder (of the user's own choosing).  Within each
  2521. folder icon is a short name (not exceeding 9 characters) for that folder.
  2522. Below this is the total number of messages minus any deleted messages.  It
  2523. may be followed by the number of un-read messages in parenthesis.  If
  2524. there are unread messages, both numbers will be displayed in red.  These
  2525. messages counts will be updated as messages are added or deleted from the
  2526. folders.
  2527.  
  2528. The height of the folder strip is defined by the font size that is used
  2529. for the folder name and the folder contents.  The font and font size that
  2530. is used can be selected by the user with the FLDRFONT= and FLDRFONTSZ=
  2531. Tool Types.  The folder icons will adjust accordingly.
  2532.  
  2533. Four pre-defined folders are provided:  "INBOX" for holding retrieved
  2534. messages, "PENDING" which holds messages that the user is currently
  2535. composing and has not decided to send as yet, "QUEUED" which holds
  2536. completed messages for later transmission, and "SENT" which holds messages
  2537. that have been sent and accepted by the SMTP Server.  Since these folders
  2538. must always be present, you can not delete or change the name of these
  2539. folders.
  2540.  
  2541. A facility has been provided to allow the user to add as many additional
  2542. folders of his own choosing that he wants to the list of folders.  As each
  2543. new folder is created, an icon will be created and placed next to the last
  2544. folder icon.  Any number of folders can be created and the "folder strip"
  2545. has the ability to scroll horizontally so that all of the folder icons can
  2546. be viewed and accessed.
  2547.  
  2548. You can use the menu items "Transfer..." and "Copy..." under the MESSAGE
  2549. menu to transfer or copy messages between folders.
  2550.  
  2551. The last window is placed below the "folder strip" and is used to display
  2552. either folder lists, address books, message lists, or messages themselves.
  2553. If a non-interlaced screen is provided, the message and address book
  2554. displays will start below the Command Icon Tool Bar (overlaying the folder
  2555. strip) rather than below the folder strip.  This is done to provide more
  2556. room for the message or address book display since the number of
  2557. displayable lines is limited.
  2558.  
  2559. Other windows are also provided which cover the entire screen below the
  2560. title bar for the purpose of providing configuration information and for
  2561. composing messages.
  2562.  
  2563. Each of the windows is described in detail in the WINDOW section below.
  2564.  
  2565. While the Command Icon Tool Bar and the folder strip are being displayed,
  2566. a contextual help line is provided in the Command Icon Tool Bar window
  2567. title bar below the screen's title bar.  As you pass the mouse cursor over
  2568. any command or folder icon, a description of that command or folder will
  2569. be displayed in the window title bar.  The main window menu bar should
  2570. also be active whenever the mouse pointer moves to the "folder strip" or
  2571. above.
  2572.  
  2573. All command and folder icons are surrounded by a raised box.  Whenever a
  2574. command or folder is selected, the box will become depressed.
  2575.  
  2576. When AEMail is first activated and you are online and have mail and accept
  2577. it's transfer, the message list for the INBOX folder will be displayed.
  2578. As each mail message is received you will see it added to the message list
  2579. of the INBOX.
  2580.  
  2581. If you are offline or there is no mail or mail is not being checked, the
  2582. folder list will be displayed.  Double clicking on either the name of a
  2583. folder in the list or one of the folder icons will cause the message list
  2584. for that folder to be displayed.
  2585.  
  2586. Double clicking on a message in the message list will cause that
  2587. particular message to be displayed.
  2588.  
  2589. If you have selected a time increment in the Configuration screen (the
  2590. default is 2 minutes), a background process will be started which checks
  2591. your POP server every few minutes (as specified by the interval) for
  2592. messages.  If there are any messages, the following requester will pop up:
  2593.  
  2594.  
  2595.                              YOU HAVE MAIL!!
  2596.  
  2597.                   n Messages available on the POP Server
  2598.  
  2599.                 Do you wish to receive these messages now?
  2600.  
  2601.  
  2602. Replying [YES] to the above requester will start the retrieval of the
  2603. messages.  This requester will only pop up when you are not in the middle
  2604. of some function such as composing a message, transferring or saving a
  2605. message, printing a message, or performing configuration changes.  It will
  2606. pop up on the Workbench screen if you have AEMail iconified.
  2607.  
  2608. NOTE:  if you did not specify that you wanted messages deleted from your
  2609. POP server as you transferred them to your Amiga, the "YOU HAVE MAIL"
  2610. requester will pop up each time the system checks for mail.
  2611.  
  2612.  
  2613.                      USING AEMail AS A "MailTo" AGENT
  2614.                      --------------------------------
  2615.  
  2616. A number of Amiga WWW Browsers allow you to select an external Mail agent
  2617. to be used for sending email when a "mailto:" HTML link is specified.
  2618. AEMail can be used as such an external  mail agent.
  2619.  
  2620. On the configuration screen for your browser specify AEMail as your
  2621. "mailto:" agent by using the full path name of AEMail and the token for
  2622. specifying the "mailto:" email address.
  2623.  
  2624. As an example, for Voyager you can specify the following:
  2625.  
  2626.     Work:AEMail/AEMail %h           or
  2627.  
  2628.     AmiTCP:bin/AEMail %h            (if you are using AmiTCP)
  2629.  
  2630. as the "mailto:" helper application in the "Network Settings:  Other"
  2631. Voyager menu or when you install Voyager.  Be sure and save your Voyager
  2632. settings once you make the change.
  2633.  
  2634. The "%h" in the above specification is Voyager's token for where to place
  2635. the email address.  The specification also assumes that AEMail was
  2636. installed in either the Work:AEMail or the AmiTCP:bin drawer.  Use the
  2637. correct full path for where you installed AEMail.  Voyager does not
  2638. require a "pubscr=" argument.
  2639.  
  2640. Other browsers, if they use this capability, may have a different way to
  2641. specify the "mailto" user agent and the token for specifying where to
  2642. place the email address.  The token may change from version to version of
  2643. your browser.  Consult your browser documentation for how to do this.
  2644.  
  2645. In early versions of AWeb, for instance, you would bring up the "Change
  2646. Settings" menu and select "External programs" in the cycle gadget.  You
  2647. entered the "mailto:" application call with two string gadgets.  The first
  2648. string gadget specifies the Command string which would be
  2649. "Work:AEMail/AEMail" (again the full path name) and the second string
  2650. gadget specifies the Argument string which would be "%s pubscn=%s".  AWeb
  2651. does use the public screen argument.  Later versions of AWeb used
  2652. different tokens for these specifications.  Consult your AWeb
  2653. documentation for what should be used.
  2654.  
  2655. The documentation for IBrowse, unfortunately, does not provide any
  2656. information on how to set up an external "mailto:" agent.  However it can
  2657. be done.  Follow these steps:
  2658.  
  2659.     Select the Preferences menu in IBrowse
  2660.     Select Network
  2661.     Select "Email & Telnet" tab
  2662.     Under "Mailto:" Set the External mode
  2663.     For the command give the full path name of the AEMail program and
  2664.         follow it with %h (like in Voyager)
  2665.  
  2666.     example:  Work:AEMail/AEMail %h
  2667.  
  2668.     Select O.K.
  2669.  
  2670.     Be sure to "Save Settings" under the Preferences menu
  2671.  
  2672. In order for the "mailto:" agent to work properly, AEMail must NOT be
  2673. running when you start up your browser.  When you click on the "mailto:"
  2674. link, AEMail will be loaded, the Compose message window will be displayed,
  2675. you will then be able to compose and send the message, and AEMail will
  2676. terminate.
  2677.  
  2678. If you have a custom configuration file, you should also add the argument
  2679. "config=name-of-config-file" to the "mailto" calling argument.  As an
  2680. example, using Voyager:
  2681.  
  2682.     Work:AEMail/AEMail %h config=name-of-file
  2683.  
  2684.                        Editing String Entry Gadgets
  2685.                        ----------------------------
  2686.  
  2687. A number of windows in AEMail use string entry gadgets for entering data.
  2688. These gadgets look like long rectangles with a cursor which allows you to
  2689. type in the data you want.  There are a number of special key combinations
  2690. that can aid you in the entry process.  These are:
  2691.  
  2692.     Cursor Left         Move cursor to previous character
  2693.     Shift Cursor Left   Move cursor to the beginning of the string
  2694.     Cursor Right        Move cursor to next character
  2695.     Shift Cursor Right  Move cursor to the end of the string
  2696.     Del                 Delete the character under the cursor
  2697.     Shift Del           Delete from the character under the cursor to the
  2698.                         end of the line
  2699.     Backspace           Delete the character to the left of the cursor
  2700.     Shift Backspace     Delete from the character to the left of the cursor
  2701.                         to the start of the line
  2702.     Return or Enter     Terminate input and deactivate the gadget
  2703.     Tab                 Terminate input and activate the next string gadget
  2704.     Shift Tab           Terminate input and activate the previous string
  2705.                         gadget
  2706.     Right Amiga q       Undo (cancel) the last editing change to the string
  2707.                         (Note: either q or Q will work)
  2708.     Right Amiga x       Clears the string (either x or X will work)
  2709.     Right Amiga v       Paste the contents of the current clipboard unit
  2710.                         to the string (either v or V will work)
  2711.     Right Amiga c       Copy the string to the current clipboard unit
  2712.                         (either c or C will work)
  2713.     Right Amiga u       Change the current clipboard unit
  2714.     Right Amiga U       Display a list of the current active clipboard
  2715.                         units and their contents
  2716.  
  2717. In addition, the following editing functions are available if the IControl
  2718. preferences editor has "Text Gadget Filter" selected.  Note: either the
  2719. upper or lower case alphabetic character will work.
  2720.  
  2721.     Ctrl A              Jump cursor to the start of the string
  2722.     Ctrl H              Delete the character to the left of the cursor
  2723.     Ctrl K              Delete from the character under the cursor to the
  2724.                         end of the line
  2725.     Ctrl M              Same as Return or Enter
  2726.     Ctrl W              Delete the previous word
  2727.     Ctrl U              Delete from the character to the left of the cursor
  2728.                         to the start of the line
  2729.     Ctrl X              Clears the string
  2730.     Ctrl Z              Jump cursor to end of the string.
  2731.  
  2732. All of the above characteristics of string editing are standard with the
  2733. Amiga with the exception of those keystrokes that involve the clipboard.
  2734. The clipboard functions are specific to AEMail, although other programs
  2735. may have similar functions using the same key combinations built into
  2736. them.  For more information on using the clipboard see "Using the
  2737. Clipboard with AEMail" below.
  2738.  
  2739.  
  2740.                       Using the Clipboard with AEMail
  2741.                       -------------------------------
  2742.  
  2743. On the Amiga, the clipboard provides a facility for passing information
  2744. from one program to another, or for saving information for re-use in the
  2745. same program.  AEMail utilizes the clipboard in several ways:
  2746.  
  2747. Each string entry gadget has the ability of copying the current contents
  2748. of the string to the clipboard or of pasting the contents of the clipboard
  2749. to the string gadget.  In that manner information can be saved and re-used
  2750. at a later time.
  2751.  
  2752. You can also obtain a line from a message, edit it, and save that to the
  2753. clipboard; or you can save the entire contents of the message body to the
  2754. clipboard.  If you are using an editor that also supports the clipboard,
  2755. you can retrieve information that you previously copied to the clipboard
  2756. and insert it into a message you are composing.
  2757.  
  2758. If your browser supports the clipboard, you can use the above method to
  2759. capture a URL that is embedded in a message and then paste it into the
  2760. browser's URL string.
  2761.  
  2762. AEMail supports the use of multiple clipboards (up to 256 separate
  2763. clipboard units), so different information can be copied to separate
  2764. clipboard units and retrieved later.  If other external programs also
  2765. support multiple clipboard units you can pass separate pieces of
  2766. information to those programs.
  2767.  
  2768. With each string entry gadget in AEMail you can use "Right Amiga C" or "Right
  2769. Amiga c" (either upper or lower case c) to copy the information from a
  2770. string to a clipboard unit.  Likewise, you can use "Right Amiga V" or "Right
  2771. Amiga v" (upper or lower case v) to paste the information into the string
  2772. gadget.  This works with all string gadgets except the "Enter Password" or
  2773. "Change Password" (in the Identity page of the Configuration Screen) string
  2774. gadgets.
  2775.  
  2776. Generally speaking when you use the paste operation in a string gadget, it
  2777. will replace the contents of the string gadget with the contents of the
  2778. clipboard.  The exception to this is with the To:, cc:, and bcc:  string
  2779. gadgets on the Compose Message Window and when editing a string that is
  2780. captured from a message (see below).
  2781.  
  2782. For the To:, cc:, and bcc:  string gadgets, the clipboard data will be
  2783. ADDED to what was previously in the string gadget.  Any added email
  2784. addresses added with the paste operation will be separated from the
  2785. previous addresses with a comma.
  2786.  
  2787. If  you  double  click  on  a  line in a message that is being displayed, a
  2788. special window will open at the top of the screen which looks like this:
  2789.  
  2790.  
  2791. |=========================================================================|
  2792. |o| Edit and save message line to clipboard                               |
  2793. |-------------------------------------------------------------------------|
  2794. |                                                                         |
  2795. | [Message line appears here                                            ] |
  2796. |                                                                         |
  2797. | [ SAVE CLIP ]              [CHANGE CLIP UNIT]              [  CANCEL  ] |
  2798. |_________________________________________________________________________|                                                                         |
  2799.  
  2800.  
  2801. You can use the copy and paste to and from the clipboard unit while you
  2802. are editing within the string entry gadget above.  However, if you paste
  2803. to the string, the data in the clipboard will be inserted at your cursor
  2804. position.  This is different from all other string entry gadgets where the
  2805. pasted data replaces whatever was in the string gadget before.  This
  2806. feature for the editing and saving of a line from a message can facilitate
  2807. building a clipboard line from different lines in the message.  To do
  2808. this, edit the first line so that just the portion that you want added or
  2809. inserted to a second line remains in the string.  Copy this to a clipboard
  2810. unit ([SAVE CLIP]).  Then double click on a second line.  Position the
  2811. cursor where you want the first clipboard data to appear and perform the
  2812. paste operation.  The previously copied data will be inserted at that
  2813. point.
  2814.  
  2815. When you click on either the [SAVE CLIP], [CANCEL], or the close gadget at
  2816. the top of the window, the edit window will disappear.  Clicking on the
  2817. [SAVE CLIP] will save the edited string to the current clipboard unit and
  2818. clicking on the [CANCEL] or close gadget will exit without saving.
  2819.  
  2820. Warning:  using the copy function from within the string gadget will
  2821. always copy the current contents of the string to the clipboard whether or
  2822. not you click on the [CANCEL] or the close gadget later.  There is no way
  2823. to undo this operation.  However, using the copy function from within the
  2824. string gadget will not close the edit window.
  2825.  
  2826. Clicking on the [CHANGE CLIP UNIT] in the edit window or typing "Right Amiga
  2827. u" (lower case u only) from any string gadget will bring up a special
  2828. window that will allow you to change the current clipboard unit.  This
  2829. window looks like this:
  2830.  
  2831.  
  2832.                          |=======================|
  2833.                          |o|Enter Clipboard Unit |
  2834.                          |-----------------------|
  2835.                          |                       |
  2836.                          | [         ] (0 - 255) |
  2837.                          |                       |
  2838.                          | [  OK  ]     [CANCEL] |
  2839.                          |_______________________|
  2840.  
  2841.  
  2842. You can enter any clipboard unit between 0 or 255 in the numeric gadget.
  2843. If you type RETURN after entering the number or click on [OK], the
  2844. clipboard unit you entered will become the new clipboard unit and the
  2845. window will close.  Clicking on the [CANCEL] gadget or the close gadget
  2846. will close the window without changing the current clipboard unit.
  2847.  
  2848. Since you may have data stored in multiple clipboard units and may forget
  2849. which clipboard unit has what data, another feature has been provided.  If
  2850. you type "Right Amiga U" (upper case U - shift and u) while you are editing
  2851. a string, the Clipboard Display window will be shown which looks like this:
  2852.  
  2853.  
  2854.                |===========================================|
  2855.                |o| Contents of Clip List                   |
  2856.                |-------------------------------------------|
  2857.                | Clip Contents                             |
  2858.                | ========================================= |
  2859.                | |  0 Contents of clip 0               | | |
  2860.                | |  2 Contents of clip 2               | | |
  2861.                | |                                     | | |
  2862.                | |                                     | | |
  2863.                | |                                     | | |
  2864.                | ========================================= |
  2865.                |                                           |
  2866.                | [  OK  ]     [NEW CLIP UNIT]     [CANCEL] |
  2867.                |___________________________________________|
  2868.  
  2869.  
  2870. This shows all of the clipboard units that have data stored in them and
  2871. the contents of each clipboard unit in a listview.  Clipboard units may be
  2872. skipped as shown in the illustration above.  Since the contents of a
  2873. clipboard can be a complete file, the first non-blank line will be
  2874. displayed and leading spaces will be stripped.  Only text clips will be
  2875. displayed.  Only 40 characters can be displayed.  If the line is longer
  2876. than 40 characters, the first 30 characters will be shown followed by
  2877. three periods and the last 7 characters.
  2878.  
  2879. Only clips with data will be shown.  The current clipboard unit will be
  2880. highlighted if it contains data.  Since it is possible to have a clipboard
  2881. unit assigned WITHOUT any data, you may see none of the units highlighted.
  2882. You can change to one of the clipboard units shown by clicking on it (it
  2883. will become highlighted) and then clicking on [OK].  You can also change to
  2884. a clipboard unit not shown by clicking on [NEW CLIP UNIT].  [CANCEL] and
  2885. the close gadget will close the window without any changes taking place.
  2886.  
  2887. A further feature of this window is to provide an automatic paste
  2888. capability by double clicking on one of the units being displayed.  That
  2889. will automatically paste the contents of the selected unit to the string.
  2890. If the selected clip is a file, only the first non-blank line will be
  2891. pasted and leading spaces will be stripped.  The "Right Amiga V" method of
  2892. pasting from within a string gadget also has this feature for multiple
  2893. line files.
  2894.  
  2895. Another clipboard feature of AEMail is the ability to save the body of
  2896. messages and text attachments to the clipboard.  When you click on the
  2897. [SAVE TEXT] or [ATTACHMENT] button when you are displaying a message you
  2898. will be given the chance to save the text as a CLIP and also to change the
  2899. clipboard unit.  See the "Message Display Window" under VIII. AEMAIL
  2900. WINDOWS for a description of the requesters that appear to do this.
  2901.  
  2902.  
  2903.                       Filtering Messages with AEMail
  2904.                       ------------------------------
  2905.  
  2906. What is message filtering?  Message filtering is the ability to direct
  2907. incoming messages to specific folders or to automatically exclude certain
  2908. messages from being stored in the system.
  2909.  
  2910. AEMail has a very powerful message filtering system.  It can direct (or
  2911. exclude) messages based upon information in the To:, From:, Reply-To:,
  2912. Subject:, cc:, bcc:, or Date: headers and (for registered users only) any
  2913. other header or text in the body of the message.  It can also use the fact
  2914. that a message is a reply, has attachments, or is forwarded as filtering
  2915. criteria.  Information in the header or body text that is checked can be a
  2916. word or phrase and wild cards can be used.  Information can also be case
  2917. sensitive or insensitive as the user desires.
  2918.  
  2919. AND and OR relationships can also be made with information coming from
  2920. different headers.
  2921.  
  2922. Filtering criteria is defined in the folder description which can be be
  2923. modified or created by using either the "Edit" or "New" sub-topic under
  2924. the "Folders menu".  See the description of the "Filter Selection Window"
  2925. under Section VIII. AEMAIL WINDOWS in this documentation for a complete
  2926. description on how to set up the filtering criteria.
  2927.  
  2928. Setting up the appropriate filtering criteria for any folder designed to
  2929. receive incoming messages with cause incoming messages (either from your
  2930. POP server or from files) to be stored in that folder rather than the
  2931. INBOX.
  2932.  
  2933. Setting up filtering criteria for the INBOX will automatically exclude any
  2934. message meeting that criteria from being stored in the INBOX.  In other
  2935. words, filtering criteria in the INBOX is used to prevent certain messages
  2936. from being stored on your system.
  2937.  
  2938. Filtering criteria can not be set up for folders designed for messages
  2939. sent out of your system.  Only messages as they are being received are
  2940. checked.  Filtering is done "on the fly" as a message enters the system.
  2941.  
  2942.                         VI. COMMAND ICON TOOL BAR
  2943.  
  2944. Below is a description of the "command icon tool bar" and the fuctions
  2945. that it performs:
  2946.  
  2947.  
  2948.                            Display Folder List
  2949.                            -------------------
  2950.  
  2951. This icon looks like a file cabinet.  Clicking on the icon will cause the
  2952. folder list to be displayed in the lower window.  This list shows each
  2953. folder with its short name (INBOX, PENDING, etc), a description of the
  2954. folder, the number of unread mesages in the folder, and the total number
  2955. of messages in the folder.
  2956.  
  2957. Unlike the count displayed in the folder icon, the total number of
  2958. messages includes any messages marked for deletion.
  2959.  
  2960.  
  2961.                            Display Address Book
  2962.                            --------------------
  2963.  
  2964. This icon looks like a closed book with the letter A on its cover.
  2965. Clicking on this icon will display the Address Book window.
  2966.  
  2967. Each address book entry contains three fields:  Nickname, Real Name, and
  2968. UserID (Address).  In addition, entries can be provided for groups with a
  2969. distribution list.  The group is identified with the heading "DISTRIBUTION
  2970. LIST" along with the number of items in the list in the top most UserID
  2971. field.  The UserID's for the members of that list are shown below that
  2972. heading.
  2973.  
  2974. For items in the distribution list, real UserID's or Nicknames can be
  2975. used.  An item in the distribution list can also be another distribution
  2976. list (In this case, only a Nickname can be used).  All nicknames are
  2977. expanded to Real Name and UserID when mail is sent.
  2978.  
  2979. A checkbox item, called "Expand" to the right of the Address Book headings
  2980. allows the user to either expand and show all members of the group or
  2981. shrink the address book so that only the group header is displayed.  This
  2982. item is normally checked indicating the groups are in expanded mode.  If
  2983. the check mark is removed, the group entries will shrink showing only the
  2984. group headings.  This feature is only available to registered users.
  2985.  
  2986. Currently, address book entries are sorted by Nickname and group entries
  2987. are interspersed with single entries.  Also Real Names are presented as
  2988. first name followed by last name rather than last name, first name.
  2989.  
  2990. If you are displaying a message, or have a message selected, when you
  2991. click on the Address Book icon, the "Reply-To:" address, if present, will
  2992. be transferred to the UserID address in the Address Book.  If the
  2993. Reply-To:  address is not present, the From:  address will be used.  If a
  2994. Real Name is present in the address it also will be transferred.  You can
  2995. force the From:  address to be transferred by holding down the shift key
  2996. when you click on the Address Book icon.  This process facilitates
  2997. transferring names and UserIDs to the Address Book.  Please keep in mind
  2998. that Reply-To: addresses normally do not have real names associated with
  2999. them, but From: addresses many times do.  If you want the real name you
  3000. may have to hold down the shift key when you click on the Address Book
  3001. icon.
  3002.  
  3003. The first time AEMail is loaded, a special Address Book entry with a
  3004. nickname of "AEMAIL" is created.  This entry can be used to send bug
  3005. reports and messages about AEMail to my email address.
  3006.  
  3007. Address book data is stored in a file in your AEMail directory called
  3008. ".addrbook".
  3009.  
  3010. A more complete description of the Address Book window is given later
  3011. under Section VIII.  AEMAIL WINDOWS, Address Book Window.
  3012.  
  3013.  
  3014.                             Retrieve Messages
  3015.                             -----------------
  3016.  
  3017. This icon looks like an envelope with an arrow coming in.  When selected,
  3018. AEMail will attempt to connect to the POP host server and transfer any
  3019. mail at the server to your Amiga.
  3020.  
  3021. If you are in offline mode (you are not connected to your Internet Service
  3022. Provider or AEMail can not connect, for some reason, to your POP server),
  3023. you will see a requester that asks:
  3024.  
  3025.  
  3026.                    !! We are running in Offline mode !!
  3027.  
  3028.                Do you wish to receive messages from files?
  3029.  
  3030.  
  3031. Clicking on [NO] will terminate the retrieval process.
  3032.  
  3033. Clicking on [YES] will bring up a file requester which will allow you to
  3034. select one or more files.  The default directory for these files is
  3035. "AMITCP:" since it is assumed that you are trying to bring in mail that
  3036. was previously transferred using another mail user agent such as AmiPOP,
  3037. AirMail, or Voodoo; however, you can switch to any other directory and
  3038. bring in any file that is in email text format.  You can also change the
  3039. default directory for retrieving off-line mail with the Path Parameters
  3040. page on the Configuration screen.
  3041.  
  3042. AEMail automatically recognizes mail stored as individual messages or as
  3043. message streams (such as stored by AmiPOP).  The only requirement is that
  3044. the message stream must separate messages with data beginning:
  3045.  
  3046.     ...<LF><LF>From [UserID]
  3047.  
  3048. where [UserID] is the UserID specified in the USERID= tool type or with
  3049. the Required Parameters page on the Configuration screen.
  3050.  
  3051. This also works with message streams saved by the "Save Message to File"
  3052. or the "Export.." item in the messages menu.
  3053.  
  3054. It is also assumed that lines have been stored in the file ending in <LF>
  3055. and not <CR><LF> (<CR> is $0D and <LF> is $0A).
  3056.  
  3057. If you encounter a message stream that does not use the above to separate
  3058. messages, please report what was used and what product was used to create
  3059. the message stream.  A copy of the message stream on floppy or sent to me
  3060. as an email attachment would be very handy.
  3061.  
  3062. If you are connected to your Internet Service Provider and connection can
  3063. be made to your POP mail server, all messages stored on the server will be
  3064. transferred to the Amiga.  They will be stored as individual messages in
  3065. the AEMAIL: directory with cryptic file names.
  3066.  
  3067. A progress window will also be displayed which will show the number of the
  3068. current message being received, the total number of messages being
  3069. received, the percentage of the current message already received and the
  3070. total bytes in the message being received.  The percentage will be shown
  3071. as both a number and a graphic slider.
  3072.  
  3073. This progress window also has an [ABORT] button which allows you to
  3074. terminate the receipt of the current and all remaining messages from your
  3075. POP Server.
  3076.  
  3077. PLEASE NOTE:  The abort process only aborts the receipt of messages into
  3078. the AMIGA, It does NOT abort the transfer of data from the POP Server.
  3079. While AEMail disconnects from the server, the server may be unaware of
  3080. this and continue to send the remainder of the message.  If AEMail
  3081. attempts to re-establish contact with the Server while it is still sending
  3082. the message AEMail may start to receive the middle of the previously
  3083. requested message.  AEMail has been programmed to recognize this and will
  3084. temporarily report that the POP connection could not be established.  Once
  3085. the POP Server finishes transferring the message, it should become
  3086. available for another connection.
  3087.  
  3088. The progress window will be shown both when retrieving messages from your
  3089. POP server and from files, however, if you are retrieving a message
  3090. stream, AEMail will not be able to correctly determine the number of
  3091. messages being retrieved.  Therefor the "n of n" indicator will be
  3092. incorrect.
  3093.  
  3094. If mail on the server is to be deleted, the "Delete Host Mail" item in the
  3095. Retrieve Messages menu must be checked.  If this menu item is not checked,
  3096. mail will NOT be deleted on your POP server.  This has no effect when you
  3097. are retrieving messages from a file.  NOTE:  the AEMail Installation
  3098. script automatically defaults to deleting host mail.  You will have to
  3099. un-check this item if you want to keep mail on your POP Server.
  3100.  
  3101. Since old mail may not be deleted on your server, a menu item has been
  3102. provided under the Retrieve Messages menu called "Excl Dup Msgs".  When
  3103. this item is checked duplicate messages from the mail server which are
  3104. currently stored in any incoming folder will not be stored again.  The
  3105. only folders not checked for duplicate messages are the PENDING, QUEUED
  3106. and any folder designed to hold SENT messages.  Again, the default action
  3107. with the installation script is to delete duplicate messages.
  3108.  
  3109. Currently, like sending messages to your Internet provider, the retrieval
  3110. process is run in the same execution mode as AEMail.  This means that all
  3111. of the messages must be received from the POP host before any other AEMail
  3112. process can take place.  Again, a future version will move the retrieval
  3113. process to a background process so you can proceed with other AEMail
  3114. functions while retrieval takes place.
  3115.  
  3116. You can be running another program on your Amiga, however when the message
  3117. retrieval takes place.  If you are in iconify mode when retrieval takes
  3118. place it will be done totally in the background although you will see the
  3119. "You have mail" requester (see below).
  3120.  
  3121. Every time a new message is retrieved AND stored, the total and new
  3122. message counts in the folder list AND the folder icon strip will be
  3123. updated.  Also the top title bar will display the following message:
  3124.  
  3125.   Message n of n retrieved[/deleted] from [POP server/file], [not] saved
  3126.  
  3127. The first n indicates the current message number and the second n
  3128. indicates the total number of messages being retrieved.  (NOTE:  This
  3129. message will also appear when local mail files are being transferred, but
  3130. the counts may not be accurate if you are retrieving from a message
  3131. stream.  Also, the retrieval process from local files is so fast, you may
  3132. only see the message for the last retrieval.)
  3133.  
  3134. The [/deleted] will appear if the message has been deleted on the POP
  3135. server and [not] will appear if the message was a duplicate and was not
  3136. saved.
  3137.  
  3138. You can check for messages on your POP server and retrieve these messages
  3139. manually any time you wish by clicking on the RETRIEVE MESSAGES icon.
  3140. Also, the user has the option of retrieving messages automatically when
  3141. AEMail is first activated (provided you are connected to your Internet
  3142. provider), each time you execute your "startnet" script from within
  3143. AEMail, and when you quit AEMail.
  3144.  
  3145. You can also set a time interval in minutes in which AEMail will
  3146. periodically check for new mail.  This function is done in the background
  3147. and if one or more messages are on your POP server, the following
  3148. requester will pop up:
  3149.  
  3150.  
  3151.                              YOU HAVE MAIL!!
  3152.  
  3153.                   n Messages available on the POP Server
  3154.  
  3155.                 Do you wish to receive these messages now?
  3156.  
  3157.  
  3158. Replying [YES] to the above requester will start the retrieval of the
  3159. messages.  This requester will only pop up when you are in the main AEMail
  3160. screen and are not in the middle of some function such as composing a
  3161. message, transferring or saving a message, printing a message, or
  3162. performing configuration changes.
  3163.  
  3164. NOTE:  if you did not specify that you wanted messages deleted from your
  3165. POP server as you transferred them to your Amiga, the "YOU HAVE MAIL"
  3166. requester will pop up each time the system checks for mail.
  3167.  
  3168.                          Display Previous Message
  3169.                          ------------------------
  3170.  
  3171. This icon is a long yellow backward arrow.  When you are displaying a
  3172. message, clicking on this icon will display the previous message in the
  3173. message list.  If you are at the first message in the list, a requester
  3174. will be displayed informing you of this.
  3175.  
  3176. A more complete description of the message display window is given under
  3177. Section VIII. AEMAIL WINDOWS, Message Display Window.
  3178.  
  3179.  
  3180.                   Display Previous Folder's Message List
  3181.                   --------------------------------------
  3182.  
  3183. This icon is a short backward arrow.  Clicking on this icon will display
  3184. the previous folder's message list.
  3185.  
  3186. A description of the message list is given under Section VIII AEMAIL
  3187. WINDOWS, Message List Window.
  3188.  
  3189.                   Display Current Folder's Message List
  3190.                   -------------------------------------
  3191.  
  3192. This icon looks like a folder.  Clicking on this icon will display the
  3193. current folder's message list.  This is one way to get back to the current
  3194. message list when you are displaying a message and the folder list is
  3195. obstructed.
  3196.  
  3197. A description of the message list is given under Section VIII AEMAIL
  3198. WINDOWS, Message List Window.
  3199.  
  3200.                     Display Next Folder's Message List
  3201.                     ----------------------------------
  3202.  
  3203. This icon is a short forward arrow.  Clicking on this icon will display
  3204. the next folder's message list.
  3205.  
  3206. A description of the message list is given under Section VIII AEMAIL
  3207. WINDOWS, Message List Window.
  3208.  
  3209.                            Display Next Message
  3210.                            --------------------
  3211.  
  3212. This icon is a long yellow forward arrow.  When you are displaying a
  3213. message, clicking on this icon will display the next message in the
  3214. message list.  If you are at the last message in the list, a requester
  3215. will be displayed informing you of this.
  3216.  
  3217.  
  3218. A more complete description of the message display window is given under
  3219. Section VIII AEMAIL WINDOWS, Message Display Window.
  3220.  
  3221.  
  3222.                             Compose A Message
  3223.                             -----------------
  3224.  
  3225. This icon looks like a sheet of paper with a pen on it.  The Compose a
  3226. Message function brings up the Compose Message window which is described
  3227. under Section VIII AEMAIL WINDOWS, Compose Message Window.  In this window
  3228. you will enter information about the message you are about to compose.
  3229. The information you enter includes the Nickname or UserID of the
  3230. receipient of the message, the subject and whether or not you want to send
  3231. cc's to anyone.
  3232.  
  3233. A special [Call Address Book] button is provided that allows you to call
  3234. up an abreviated version of the Address Book.  By clicking on an address
  3235. book name you can transfer the nickname for that address to any of the
  3236. To:, cc:, or bcc:  fields.  You select the field you want to transfer the
  3237. nickname to by a special cycle gadget in the address book display.
  3238.  
  3239. When the Address Book is displayed from the Compose window, all groups
  3240. will show as the group header and number of entries in that group.  For
  3241. AEMail registered users, an [Expand] checkmarked gadget will allow you to
  3242. expand the groups so you can see all of the entries.  Exiting from the
  3243. Address Book display is accomplished by double clicking on an address (it
  3244. will be transferred to the appropriate field and then the Address Book
  3245. will be closed) or by clicking on the Close gadget in the window border or
  3246. at the bottom of the window.
  3247.  
  3248. To compose the message text you would click on the [Compose/Edit Message]
  3249. which will call up your editor.  When you save and exit from the editor,
  3250. you will be brought back to the Compose Message window.
  3251.  
  3252. You can specify the format that you want you text to be sent as.  You can
  3253. select between 8-bit, 7-bit, quoted-printable, or encoded binary (BASE64).
  3254. This facilitates sending messages with foriegn character sets through
  3255. gateways that only handle 7 bit data.  The default is 8 bit.  Both
  3256. "quoted-printable" and "encoded binary" are 7 bit schemes for representing
  3257. 8 bit data.  When you display a message which is in either
  3258. "quoted-printable" or "encoded binary", it will be displayed correctly.
  3259.  
  3260. You can also specify any attachments you want to send with the message
  3261. through the Add Attachment Requester or you can specify a signature file
  3262. or additional headers.
  3263.  
  3264. After supplying the required information, you can then save your message
  3265. into either the PENDING or QUEUED folder or send it directly.  If you
  3266. select [Send Message Now] you MUST be connected to your Internet provider.
  3267.  
  3268. If a message has been selected in any folder, except the PENDING, QUEUED,
  3269. or SENT folders, before clicking on the COMPOSE MESSAGE icon, the compose
  3270. will be treated as a reply to the selected message.  The original Reply-To
  3271. address for the message you are replying to will appear in the To:  field
  3272. on the Compose window.  If the Reply-To:  address is not present the From:
  3273. field will be used as recipient of the reply.  You can force the From:
  3274. field to be used by holding down the shift key when you click on the
  3275. Compose icon.
  3276.  
  3277. If you are not interested in creating a reply, you can change to creating
  3278. a new message to be sent to the same (or different) recipient, or you can
  3279. forward the message to a different recipient.
  3280.  
  3281. If the message selected was in the PENDING or QUEUED folder, you will be
  3282. allowed to either edit the selected message or create a new message.  If
  3283. you edit the message it will be stored back into the the folder you
  3284. selected or will be sent (if you click on [Send Message Now].  The old
  3285. message will be automatically removed from the system.
  3286.  
  3287. If the message selected was in the SENT folder you will only be able to
  3288. create a new message.
  3289.  
  3290.                      Queue Message For Later Delivery
  3291.                      --------------------------------
  3292.  
  3293. This icon looks like a mailbox.  This function is provided to allow the
  3294. user to mark messages that you want sent later.  Normally, NO MORE EDITING
  3295. OF THESE MESSAGES should occur once they are moved to the QUEUED folder.
  3296. However, AEMail does allow this to occur.  Messages can be moved back to
  3297. the PENDING folder with the "Transfer..." item in the Messages menu.
  3298. Messages for queuing must come from the PENDING folder.  The messages can
  3299. also be placed in either the PENDING or QUEUED folders (or sent) by the
  3300. Compose Message window.
  3301.  
  3302. You can send these messages manually from the QUEUED folder any time you
  3303. want by either sending the entire folder or individual messages in the
  3304. folder.  This is done by selecting the QUEUED folder and clicking on the
  3305. SEND IMMEDIATE icon (see above) or by selecting the "Send Queued Mail"
  3306. item under the PROJECT menu.
  3307.  
  3308. AEMail also allows the user the option of sending queued messages
  3309. automatically when AEMail is first activated, or when the program
  3310. terminates provided you are connected to your Internet provider (see
  3311. Section V.  STARTING AEMAIL, above).  It will also perform this check when
  3312. you make connection to your Internet provider through the StartNet script
  3313. unless you have disabled this feature with the TCP/IP Parameters page of
  3314. your Configuration screen.
  3315.  
  3316. With this option you can compose messages when you are in an off-line
  3317. mode, save them in PENDING while you are working on them, and then QUEUE
  3318. them when you are satisfied with the message you want to send.  The Queued
  3319. messages are then automatically sent when you log onto your Internet
  3320. Provider by the StartNet command.
  3321.  
  3322. If messages are selected in the PENDING folder when you click on the QUEUE
  3323. MESSAGE icon, a requester will appear that asks:
  3324.  
  3325.     Do you wish to queue the entire pending folder
  3326.     or just selected messages?
  3327.  
  3328. The choices available are:
  3329.  
  3330.        [ENTIRE FOLDER]     [SELECTED MESSAGES]     [CANCEL QUEUING]
  3331.  
  3332. If no messages have been selected (or if all of the messages have been
  3333. selected), the entire PENDING folder will be queued without a requester
  3334. appearing.  Deleted messages in the PENDING folder are never queued.
  3335.  
  3336. If there are no undeleted messages in the PENDING folder a notification
  3337. requester will appear that indicates that "No messages available to
  3338. queue".
  3339.  
  3340. The messages that are selected will be placed in the QUEUED folder and
  3341. removed from the PENDING folder.
  3342.  
  3343.                          Send Message Immediately
  3344.                          ------------------------
  3345.  
  3346. This icon looks like an envelope with an arrow going out.  An attempt will
  3347. be made to send the Selected Message(s) to their recipients.  The messages
  3348. to be sent must be in either in the PENDING or QUEUED folder.  The
  3349. messages will be sent from the PENDING folder only if the PENDING folder
  3350. is selected; otherwise they will be sent from the QUEUED folder.
  3351.  
  3352. If messages are selected, a requester will appear that asks:
  3353.  
  3354.     Do you wish to send the entire [pending/queued] folder
  3355.     or just selected messages?
  3356.  
  3357. The choices available are:
  3358.  
  3359.         [ENTIRE FOLDER]     [SELECTED MESSAGES]     [CANCEL SEND]
  3360.  
  3361. If no messages have been selected or all of the messages in the folder are
  3362. selected, the entire selected folder will be sent without a requester
  3363. appearing.  Deleted messages are never sent.
  3364.  
  3365. If there are no undeleted messages in the selected folder a notification
  3366. requester will appear that indicates that "No messages available to send".
  3367.  
  3368. A check will then be made to see if you have an active connection to your
  3369. Internet provider.  If you do not, a requester will be displayed which
  3370. informs the user that we are in offline mode and that the messages can not
  3371. be sent.
  3372.  
  3373. If you are connected to your Internet Provider, a message will appear in
  3374. the top title bar that says "Connecting to SMTP Host to send mail".  Once
  3375. the SMTP connection is made.  AEMail will display "Starting to send n
  3376. messages" where n is the number of messages selected to send.  If we are
  3377. unable to connect or an error is reported back from your Internet
  3378. provider, a message will appear in the title bar showing the nature of the
  3379. error and the messages will not be sent.
  3380.  
  3381. Sometimes, if the error message is from your Internet Provider, you will
  3382. not be able to see all of it.  If your TCPLOG is active, you will be able
  3383. to see it on the Log File, however.
  3384.  
  3385. A progress window will also be displayed which will show the current
  3386. number of the message being sent, the total number of messages being sent,
  3387. the percentage of the current message already sent and the total bytes in
  3388. the current message being sent.  The percentage will be shown as both a
  3389. number and a graphic slider.
  3390.  
  3391. If there is more than one recipient for the message, the progress
  3392. indicator will also show "Sending to n of n recipients of message" as each
  3393. recipient of the message is contacted.  This way you will see the progress
  3394. of contacting recipients for large groups of recipients.
  3395.  
  3396. This progress window also has an [ABORT] button which allows you to
  3397. terminate the sending of the current and all remaining messages to your
  3398. SMTP Server.
  3399.  
  3400. All nicknames used in To:, cc:, and bcc:  header fields will be expanded
  3401. to the form:  Real Name<userid>.  Group nicknames will be expanded to the
  3402. Real Names and userids of all members of the group, or, if "Send Header
  3403. Only" is set for that group, only the group header will be displayed in
  3404. the To:  field.
  3405.  
  3406. When each message is successfully sent, the following message will be
  3407. displayed in the upper title bar:
  3408.  
  3409.     Mail n of n successfully sent to [To: addressee]
  3410.  
  3411. The n in the above message indicates the message number and the total
  3412. messages to be sent.  The [To:  addressee] indicates who the message was
  3413. addressed to.  If it was addressed to multiple addressees, the first
  3414. addressee will appear followed by ", et al...".
  3415.  
  3416. The message will also be placed in the SENT folder and marked as deleted
  3417. in the PENDING or QUEUED folder.
  3418.  
  3419. In the current version of AEMail, the send process operates in the same
  3420. execution mode as AEMail.  This means that you can not perform any other
  3421. AEMail operation until the message is either rejected by your Internet
  3422. provider or successfully received by your provider (unless you abort the
  3423. process).  In a future version, this process will be moved to a background
  3424. process so that you can perform work in AEMail while the sending of the
  3425. message proceeds.
  3426.  
  3427.  
  3428.                       Save (Export) Message To File
  3429.                       -----------------------------
  3430.  
  3431. This icon looks like a diskette.  A message must be selected before
  3432. activating this function and multiple messages can be selected.  A message
  3433. that is currently being displayed is considered a selected message.
  3434.  
  3435. You can save multiple messages as a block of messages or as individual
  3436. messages.  If you have selected multiple messages a requester will be
  3437. displayed as follows:
  3438.  
  3439.                    More than one message marked to save
  3440.  
  3441.                    Do you want to save them as a group
  3442.                              or Individually
  3443.  
  3444.                         If you select Individually
  3445.                        a File Requester will appear
  3446.                              for each message
  3447.  
  3448.                 [Save as Group]        [Save Individually]
  3449.  
  3450.  
  3451. Unless you are saving the messages as a group, a requester will also be
  3452. displayed for each message which will describe the message as to Date,
  3453. From, To, and Subject and ask you if you want to perform the requested
  3454. action.  Selecting [SAVE] will display a file requester in which you will
  3455. be asked to enter the file name you want the message saved as, and
  3456. selecting [CANCEL] will not save the current message.
  3457.  
  3458. If you are saving the message as a group, only the file requester will
  3459. appear.
  3460.  
  3461. The complete message, including all attachments, is saved in the format in
  3462. which the message was received from the POP server except that
  3463. CARRAGE-RETURN/LINEFEED sequences are stored as LINEFEEDs alone.  Also,
  3464. the message ending sequence (.<CR><LF>) is eliminated and any embedded
  3465. ..<CR><LF> are changed to .<LF> as they would normally appear in a
  3466. message.
  3467.  
  3468. If the messages are saved as a group, each message will have a special
  3469. header separating it from the following message.  This header consists of
  3470. a line feed followed by:
  3471.  
  3472.     From [your UserID]@[Your POP Server name] [date]
  3473.  
  3474. Only the special header (not the line feed) will appear for the first
  3475. message.
  3476.  
  3477.  
  3478. This facilitates importing a group of messages back into AEMail. (See
  3479. the Retrieve Messages command and the menu item From Local File...  under
  3480. the Retrieve Msgs menu.)
  3481.  
  3482. If you want to save the body of the message or an attachment in its
  3483. converted format, you can do that with either the [SAVE TEXT] gadget in
  3484. the message display window or with the Attachment Requester that can be
  3485. brought up when you display a message with attachments (see Attachment
  3486. Requester under VIII.  AEMAIL WINDOWS below).
  3487.  
  3488.  
  3489.                                   Print
  3490.                                   -----
  3491.  
  3492. This icon looks like a printer.  You must select the messages you want
  3493. printed prior to selecting this icon.  Multiple message selection works
  3494. with this command.  If no messages have been selected, you will be asked
  3495. if you want to print a list of the messages in that folder.  Also, if this
  3496. icon is selected while you are in the Address Book, the address book
  3497. contents will be printed.
  3498.  
  3499. Each of the messages will be printed in the order that they appear in your
  3500. message list.  All selected messages will be printed whether they are
  3501. marked for deletion or not.
  3502.  
  3503. A progress indicator will appear as each message is being sent to your
  3504. printer which shows the percent being printed and the total bytes being
  3505. printed.  This progress indicator has an [ABORT] button which allows you
  3506. to terminate the printing.  However, beware, most printers have a
  3507. substantial buffer which will probably receive all of your messages quite
  3508. quickly.  Once the messages are in the printer's buffer, the printing can
  3509. not be cancelled without turning your printer off.
  3510.  
  3511. A heading line will be printed on each page of the listing which contains
  3512. the following information:
  3513.  
  3514. Message Sent on MM/DD/YY (DOW) at HH:MM [AM/PM], [from/to] [name]  Page n
  3515.  
  3516. where
  3517.  
  3518.     MM/DD/YY is the date the message was sent (received) or composed,
  3519.     DOW is the day of the week the message was sent (received) or
  3520.         composed,
  3521.     HH:MM is the hour and minute the message was sent (received) or
  3522.         composed using a 12 hour clock,
  3523.     [AM/PM] is either AM or PM.
  3524.     [from/to] if the message was received you will see "from", and if you
  3525.         composed or sent the message you will see "to",
  3526.     [name] the full name of the sender or nickname of recipient,
  3527.     n is the the page number.
  3528.  
  3529. On the first page only, if there are attachments, the following line will
  3530. appear below the heading line:
  3531.  
  3532. This message has attachments (See last page for list).
  3533.  
  3534. On a separate page after the message, the attachment list will appear,
  3535. providing the "Include Attachment List in Print Out" item is checkmarked
  3536. in the General Parameters portion of the Configuration screen.  Printing
  3537. the attachment list is the default action.
  3538.  
  3539. If attachments are a Text or Message type and are either 7-bit, 8-bit, or
  3540. quoted-printable encoding format they will be printed following the body
  3541. of the message.  Other types of attachments you will have to save to a
  3542. file and print the file with an appropriate printing program.
  3543.  
  3544. Note:  no check is made whether a selected message is deleted or not.  If
  3545. a deleted message is selected it will be printed anyway (this is probably
  3546. desireable in certain circumstances).  If you don't want to print it,
  3547. de-select it!
  3548.  
  3549. This function can also print a list of all messages in a folder.  To do
  3550. this, DO NOT select any messages in the folder.  A requester will appear
  3551. when you select either the printer command icon or the Print menu item
  3552. which says:
  3553.  
  3554.  
  3555.                       No messages selected to print!
  3556.  
  3557.                        Do you want to print a list
  3558.                         of all the messages in the
  3559.                          [name of folder] folder?
  3560.  
  3561.                       [YES]                     [NO]
  3562.  
  3563. By selecting [YES] you will print a list of the messages.  Messages will
  3564. be printed in the order that they appear in the message list.
  3565.  
  3566. Selecting [NO] will terminate the printing function.
  3567.  
  3568. Printing uses your Preferences Printer.  You should set it up properly
  3569. before executing AEMail, but you can set it up while in AEMail by using
  3570. the General Parameters page on the Configuration screen.  You can also
  3571. specify a print file that the output will be directed to.
  3572.  
  3573. As a default AEMail will space 4 lines down before starting to print.
  3574. This "Top Margin", however, can be changed in the General Parameters page
  3575. of the Configuration screen.
  3576.  
  3577.  
  3578.                          Delete/Undelete Messages
  3579.                          ------------------------
  3580.  
  3581. This icon looks like a garbage can.  This will delete OR undelete all
  3582. messages that have been selected in a message list.  Whether deleting or
  3583. undeleting takes place depends on the current status of the message.  If
  3584. it is currently marked for deletion, it will be undeleted.
  3585.  
  3586. This function only marks (or unmarks) messages for deletion.  The messages
  3587. will actually be deleted only when AEMail exits.  The message counts in
  3588. the folder icons, however, will only represent undeleted messages.  You
  3589. can also suppress the display of deleted messages in the message list by
  3590. unchecking the Show/Deleted Messages item under the Messages menu.
  3591.  
  3592.                   Copy Selected Messages to a new folder
  3593.                   --------------------------------------
  3594.  
  3595. This icon looks like two sheets of paper, one laying over the other.  This
  3596. will copy all selected messages from the selected folder to a new folder.
  3597. When you select this icon a Notification window appears which says:
  3598.  
  3599.  
  3600.                     Select Folder to Copy Messages To!
  3601.  
  3602.                                  [CANCEL]
  3603.  
  3604.  
  3605. When the window appears, click on the folder icon that represents the
  3606. folder you want the messages copied to.  The window will automatically
  3607. disappear at that time.
  3608.  
  3609. The selected messages will be copied to that folder.  Messages will remain
  3610. in both folders.
  3611.  
  3612. Clicking on [CANCEL] before clicking on a folder will cancel the
  3613. operation.
  3614.  
  3615. As the messages are being copied, the folder message list that the
  3616. messages are copied to will be displayed (unless a message is being
  3617. displayed).  Once the copy is complete, the folder message list from which
  3618. the messages are copied will be displayed unless a message is being
  3619. displayed.
  3620.  
  3621.  
  3622.                 Transfer Selected Messages to a new folder
  3623.                 ------------------------------------------
  3624.  
  3625. This icon looks like a sheet of paper with arrows pointing to the right.
  3626. It will move all selected messages from the selected folder to a new
  3627. folder.  When you select this icon a Notification window appears which
  3628. says:
  3629.  
  3630.  
  3631.                   Select Folder to Transfer Messages To!
  3632.  
  3633.                                  [CANCEL]
  3634.  
  3635.  
  3636. When the window appears, click on the folder icon that represents the
  3637. folder you want the messages transferred to.  The window will
  3638. automatically disappear at that time.
  3639.  
  3640. The selected messages will be copied to that folder, and the messages in
  3641. the folder from which the messages are copied will be marked as "deleted".
  3642.  
  3643. Clicking on [CANCEL] before clicking on a folder will cancel the
  3644. operation.
  3645.  
  3646. As the messages are being transferred, the folder message list that the
  3647. the messages are transferred to will be displayed (unless a message is
  3648. being displayed).  Once the transfer is complete, the folder message list
  3649. from which the messages are copied and deleted will be displayed unless a
  3650. message is being displayed.
  3651.  
  3652.  
  3653.                      Start TCP/IP Network Connection
  3654.                      -------------------------------
  3655.  
  3656. This icon looks like a horizontal jagged line.  This will start your
  3657. network connection to your Internet Provider using your StartNet script.
  3658. It performs the same function as the "Start Net" item under the TCP/IP
  3659. menu (see below under Section VII, AEMAIL MENUS.
  3660.  
  3661.                    Terminate TCP/IP Network Connection
  3662.                    -----------------------------------
  3663.  
  3664. This icon looks like a horizontal jagged line with a red slash through it.
  3665. This will terminate your network connection to your Internet Provider
  3666. using your StopNet script.  It performs the same function as the "Stop
  3667. Net" item under the TCP/IP menu (see below under Section VII, AEMAIL
  3668. MENUS.
  3669.  
  3670.                             VII. AEMAIL MENUS
  3671.  
  3672. Below is a list of all the current menus and menu sub-items and a description
  3673. of their functions:
  3674.  
  3675.  
  3676.                                Project menu
  3677.                                ------------
  3678.  
  3679. Configuration...
  3680.  
  3681.     This has five submenu items for controlling your configuration.
  3682.     These sub-menu items are:
  3683.  
  3684.     Open...
  3685.  
  3686.         This brings up a file requester which allows you to specify
  3687.         a configuration file other than the standard "s:aemail.cnfg"
  3688.         file.  Once you have opened this configuration file it
  3689.         becomes your current active configuration.
  3690.  
  3691.     Edit...
  3692.  
  3693.         The Configuration screen will be activated allowing complete
  3694.         configuration data to be entered for the current active
  3695.         configuration file.  See the description of the
  3696.         Configuration screen previously under the IV.  CONFIGURATION:
  3697.         section in this document for details on the configuration
  3698.         screen.
  3699.  
  3700.     Save
  3701.  
  3702.         This will save the current configuration settings in the
  3703.         currently active configuration file.  It serves the same
  3704.         purpose as the previously "Save Settings" menu item (AEMail
  3705.         versions prior to 1.13) in which all of the current settings
  3706.         including the current state of the "Display Full Hdr",
  3707.         "Incl Hdr in Resp", "Excl Dup Msgs" and "Delete Host
  3708.         Mail" menu items.
  3709.  
  3710.     Save As...
  3711.  
  3712.         This is the same as "Save" except that a file requester
  3713.         will be brought up which allow you to rename the current
  3714.         active configuration file.  The new name becomes the
  3715.         new current active configuration file.
  3716.  
  3717.     Restore Default
  3718.  
  3719.         This reads in the s:aemail.cnfg file OR the file specified
  3720.         in the CONFIG= Tool Type OR the config= parameter on the
  3721.         Shell call to AEMail.  The particular file that is used
  3722.         is referred to as your "base configuration".  The base
  3723.         configuration now becomes your currently active
  3724.         configuration file.
  3725.  
  3726.  
  3727. Send Queued Mail
  3728.  
  3729.     Will send all messages in the QUEUED folder.  See the
  3730.     SEND MESSAGE IMMEDIATELY command in the COMMAND ICON STRIP
  3731.     section above.  This action will also occur automatically
  3732.     when you first load and when you exit AEMail provided you
  3733.     are connected to your Internet provider.
  3734.  
  3735.  
  3736. Iconify AEMail
  3737.  
  3738.     You can iconify AEMail with an iconify bar on the Workbench screen
  3739.     with this menu item.  When this menu item is selected, the AEMail
  3740.     screen will be closed and a button bar will appear on the Workbench
  3741.     screen with
  3742.  
  3743.               AEMail (Click on Close or with RMB to restore)
  3744.  
  3745.     in the title.  When the iconified bar is in selected mode, clicking
  3746.     either on the close gadget or with the right mouse button will restore
  3747.     the AEMail screen.
  3748.  
  3749.     Initially the iconify bar will open at the top center of the
  3750.     Workbench screen, but it can be dragged anywhere on the screen.
  3751.     AEMail remembers where you dragged the bar so the next time
  3752.     you iconify, the bar will be at that new position.
  3753.  
  3754.     There is also a hotkey provided for iconifying AEMail.  This is
  3755.     RIGHT-AMIGA-I.  This hot key, and also LEFT-AMIGA-I, will also
  3756.     restore the AEMail screen when in the iconify mode.
  3757.  
  3758.     When in iconify mode, periodic checking of mail on your POP server
  3759.     is still done.  If mail is found, the "YOU HAVE MAIL" requester
  3760.     will pop up on the Workbench mail.  You can retrieve the mail
  3761.     immediately by clicking on the YES gadget.  The requester will
  3762.     disappear and retrieval of messages will occur in the background
  3763.     and no progress indicator will appear.  When you return to the
  3764.     AEMail screen, the new messages will be in your INBOX folder.
  3765.  
  3766.     You can also push the AEMail screen to the back exposing the
  3767.     screen immediately behind the AEMail screen or the WorkBench
  3768.     screen by hitting LEFT-AMIGA-M when the AEMail screen is being
  3769.     displayed.  This is standard Amiga action.
  3770.  
  3771.     If the AEMail screen has been pushed to the back, hitting
  3772.     LEFT-AMIGA-M will bring the screen forward.  Note:  if other
  3773.     screens, besides the Workbench screen, are also present, they
  3774.     may be moved to the front first so that you may have to hit
  3775.     LEFT-AMIGA-M several times before the AEMail screen appears.
  3776.  
  3777.     Since there is no screen to bring forward, this will not work
  3778.     if the iconify action has been taken.
  3779.  
  3780.  
  3781. About...
  3782.  
  3783.     This will display the name, version, and date of the program
  3784.     followed by information as to whether or not the shareware
  3785.     registration message has been received and who the version is
  3786.     registered to (with serial number).
  3787.  
  3788.     Below that is information on how to contact the author of the
  3789.     program.
  3790.  
  3791.  
  3792. Quit...
  3793.  
  3794.     Exits AEMail.
  3795.  
  3796.     When this menu item is selected, AEMail first checks to see
  3797.     if you are connected to your Internet provider.  If you are, a
  3798.     connection will be made to your POP server to see if there are
  3799.     any messages available on the server.  If there are, the following
  3800.     requester will appear:
  3801.  
  3802.                   n Messages Available on the POP Server
  3803.  
  3804.                 Do you wish to receive these messages now?
  3805.  
  3806.     If you click on the [YES] button, those message will be retrieved
  3807.     at this point.  If you click on [NO], no message retrieval will take
  3808.     place.
  3809.  
  3810.     After AEMail checks to see if any messages are available on the
  3811.     POP Server, it also checks to see if any messages are in the
  3812.     QUEUED folder (messages queued to be sent).  If there are, the
  3813.     following requester will appear:
  3814.  
  3815.                   You have n messages queued to be sent
  3816.  
  3817.                  Do you wish to send these messages now?
  3818.  
  3819.     If you click on the [YES] button, all of the messages in the QUEUED
  3820.     folder will be sent immediately.  If you click on [NO], the queued
  3821.     messages will not be sent.
  3822.  
  3823.     After checking for POP messages and QUEUED messages, the following
  3824.     requester will appear:
  3825.  
  3826.             Do you wish to terminate your Host connection now?
  3827.  
  3828.     Selecting the [YES] button will cause the "stopnet" script to be
  3829.     executed terminmating your TCP/IP connection to your Internet
  3830.     provider.
  3831.  
  3832.     You can disable all of these requesters with a checkmarked item
  3833.     in the TCP/IP display on the Configuration screen.  If they are
  3834.     disabled, the [NO] action will be assumed which each of the
  3835.     requesters.
  3836.  
  3837.     Finally, a requester will be displayed that asks:
  3838.  
  3839.                        Do You Really Want to Quit?
  3840.  
  3841.     Clicking on [YES] will terminate the program and [NO] will return to
  3842.     the program.
  3843.  
  3844.     When AEMail exits, all messages marked for deletion will be
  3845.     deleted and any configuration files in which data has been updated
  3846.     will be re-written.  You will probably see a great deal of disk
  3847.     activity at this time.  While this disk activity is going on, a
  3848.     window will be displayed on the Workbench screen saying:
  3849.  
  3850.  
  3851.                  Updating all AEMail Configuration Files!
  3852.  
  3853.  
  3854.     When updating is complete, this window will disappear.
  3855.     WARNING:  DO NOT turn your computer off while this window is being
  3856.     displayed.  If you do your disk will be corrupted!
  3857.  
  3858.  
  3859.                                Folders menu
  3860.                                ------------
  3861.  
  3862. New...
  3863.  
  3864.     The Configure Folder window will be activated indicating that a new
  3865.     folder should be created.  See the description of the Configure Folder
  3866.     window later in this document for details on how to create a new
  3867.     folder.
  3868.  
  3869. Edit...
  3870.  
  3871.     The Configure Folder window will be activated indicating that the
  3872.     current selected folder description should be edited.  The current
  3873.     selected folder is the folder that has a depressed frame.  You can
  3874.     change the selected folder by single clicking on the appropriate
  3875.     folder icon or selecting a folder from the folder list.  See the
  3876.     description of the Configure Folder window later in this document for
  3877.     details on how to change the folder description.
  3878.  
  3879. Delete...
  3880.  
  3881.     This will delete the folder that has been selected.  You will not be
  3882.     able to delete a folder that has active messages in it.  If there are
  3883.     only deleted messages in the folder, the messages will be immediately
  3884.     deleted along with the folder.  There is no way you can get these
  3885.     deleted messages back.
  3886.  
  3887. Set Sort Key...
  3888.  
  3889.     Activates the Set Sort Key window for the current selected folder.
  3890.     See the description of the Set Sort Key window later in this document
  3891.     for details on how to set the folder sort keys.
  3892.  
  3893. Remove DELETED msgs
  3894.  
  3895.     This will IMMEDIATELY remove ALL messages marked for deletion in the
  3896.     current active folder.  This means that they will no longer appear in
  3897.     the message list for that folder and they will be physically deleted
  3898.     from your mail directory.
  3899.  
  3900.     Before actually removing the messages the following requester will
  3901.     appear:
  3902.  
  3903.                This will remove all deleted messages in the
  3904.                            [folder_name] folder
  3905.                 If you continue you can not retrieve them!
  3906.  
  3907.     You will given the option to either [CONTINUE] or [CANCEL].  If you
  3908.     select [CONTINUE] all the messages marked for deletion in the folder
  3909.     will be removed.  [CANCEL] will abort the operation.
  3910.  
  3911.     A busy pointer will be displayed while the messages are being removed.
  3912.  
  3913.  
  3914.  
  3915.                               Messages menu
  3916.                               -------------
  3917.  
  3918. Show
  3919.  
  3920.     This has two checkmarked submenu items for controlling your message
  3921.     list display.  These sub-menu items are:
  3922.  
  3923.     Deleted Messages
  3924.  
  3925.         If this sub-item is checked, deleted messages will be shown in the
  3926.         message list.  If it is unchecked, deleted messages will not be
  3927.         shown.  This sub-item is checked when AEMail first comes up.
  3928.  
  3929.     UnRead Msgs Only
  3930.  
  3931.         If this sub-item is checked, only unread messages will be
  3932.         displayed in the message list.  If it is unchecked all messages
  3933.         will be displayed.  This sub-item is unchecked when AEMail first
  3934.         comes up.
  3935.  
  3936. Compose...
  3937.  
  3938.     Activates the Compose Message window, described later in this
  3939.     document, to create a NEW message to be sent whether or not a message
  3940.     is currently selected.
  3941.  
  3942. Reply
  3943.  
  3944.     Activates the Compose Message window to reply to the current selected
  3945.     message.  See the description of the Compose Message window later in
  3946.     this document.
  3947.  
  3948.     There are two sub-menus which are:
  3949.  
  3950.     Use Reply-To...
  3951.  
  3952.         The Reply-To: address of the selected message will be used as the
  3953.         recipient of the reply.  If the Reply-To:  address is not present,
  3954.         the From:  address will be used.
  3955.  
  3956.     Use From...
  3957.  
  3958.         This forces the From: address to be used as the recipient of the
  3959.         reply.
  3960.  
  3961.     If a message is not selected when one of the sub-menu items is
  3962.     activated an error requester will appear.
  3963.  
  3964. Forward...
  3965.  
  3966.     Activates the Compose Message window to forward the current selected
  3967.     message.  See the description of the Compose Message window later in
  3968.     this document.
  3969.  
  3970.     If a message is not selected when this menu item is activated an error
  3971.     requester will appear.
  3972.  
  3973. Edit...
  3974.  
  3975.     Using this menu item will allow you to edit a message selected in
  3976.     either the PENDING or QUEUED folders.  It has the same effect as
  3977.     clicking on the Compose icon when you have selected a message in
  3978.     either the PENDING or QUEUED folders.
  3979.  
  3980.     If you have not selected a message in either the PENDING or QUEUED
  3981.     folder when this menu item is activated an error requester will
  3982.     appear.
  3983.  
  3984.  
  3985. Select None
  3986.  
  3987.     This menu item will de-select all messages in the selected folder.
  3988.  
  3989. Select All
  3990.  
  3991.     This menu item will select all messages in the selected folder.
  3992.     Selected messages will be marked with an asterick (*) in the first
  3993.     position of the message in the message list display.
  3994.  
  3995. Last Selected
  3996.  
  3997.     This menu item will re-select those messages that were last selected.
  3998.     If you did a multiple selection on a group of messages and then
  3999.     performed an operation on the group of messages (such as deleting,
  4000.     copying, saving the group to a file, etc.), the messages will be
  4001.     de-selected as the operation is performed on each message.  The "Last
  4002.     Selected" menu item will allow you to re-select the same previously
  4003.     selected messages so that you can perform another operation on the
  4004.     same group of messages.
  4005.  
  4006. Export...
  4007.  
  4008.     Same as the SAVE MESSAGE TO FILE command described previously in this
  4009.     document.
  4010.  
  4011. Copy...
  4012.  
  4013.     This menu copies all selected messages from the selected folder to a
  4014.     new folder.  When you select this menu a Notification window appears
  4015.     which says:
  4016.  
  4017.  
  4018.                     Select Folder to Copy Messages To!
  4019.  
  4020.                                  [CANCEL]
  4021.  
  4022.  
  4023.     When the window appears, click on the folder icon that represents the
  4024.     folder you want the messages copied to.  The window will automatically
  4025.     disappear at that time.
  4026.  
  4027.     The selected messages will be copied to that folder.  Messages will
  4028.     remain in both folders.
  4029.  
  4030.     Clicking on [CANCEL] before clicking on a folder will cancel the
  4031.     operation.
  4032.  
  4033.     As the messages are being copied, the folder message list that the
  4034.     messages are copied to will be displayed (unless a message is being
  4035.     displayed).  Once the copy is complete, the folder message list from
  4036.     which the messages are copied will be displayed unless a message is
  4037.     being displayed.
  4038.  
  4039.  
  4040. Transfer...
  4041.  
  4042.     This menu moves all selected messages from the selected folder to a
  4043.     new folder.  When you select this menu a Notification window appears
  4044.     which says:
  4045.  
  4046.  
  4047.                   Select Folder to Transfer Messages To!
  4048.  
  4049.                                  [CANCEL]
  4050.  
  4051.  
  4052.     When the window appears, click on the folder icon that represents the
  4053.     folder you want the messages transferred to.  The window will
  4054.     automatically disappear at that time.
  4055.  
  4056.     The selected messages will be copied to that folder, and the messages
  4057.     in the folder from which the messages are copied will be marked as
  4058.     "deleted".
  4059.  
  4060.     Clicking on [CANCEL] before clicking on a folder will cancel the
  4061.     operation.
  4062.  
  4063.     As the messages are being transferred, the folder message list
  4064.     that the the messages are transferred to will be displayed (unless a
  4065.     message is being displayed).  Once the transfer is complete, the
  4066.     folder message list from which the messages are copied and deleted
  4067.     will be displayed unless a message is being displayed.
  4068.  
  4069.  
  4070. Print
  4071.  
  4072.     Same as the PRINT SELECTED MESSAGES command described previously in
  4073.     this document.
  4074.  
  4075.  
  4076. Delete/Undelete...
  4077.  
  4078.     Same as the DELETE/UNDELETE MESSAGE command described previously in
  4079.     this document.
  4080.  
  4081. Display Full Hdr
  4082.  
  4083.     This is a checkmarked menu sub-item.  When checked, all message
  4084.     headers will be displayed in the message.  Since many of these headers
  4085.     are somewhat cryptic and could be confusing and not always understood
  4086.     by the user, the normal action is display only certain header lines.
  4087.     The default action is to display the following headers:  From:,
  4088.     Reply-To:  To:, Date:, Subject:, Organization:, cc:, and bcc:, but you
  4089.     can control this default minimum header list with the General
  4090.     Parameters page of the Configuration screen.
  4091.  
  4092.     This menu sub-item is very useful for debugging purpose to see all of
  4093.     the headers what any particular message carries.
  4094.  
  4095.     The current state of this checkmarked item is saved in the aemail.cnfg
  4096.     file whenever the "Save Settings" menu item is selected.  It can also
  4097.     be set or reset by the General Parameters page on the Configuration
  4098.     screen.
  4099.  
  4100. Incl Hdr in Resp
  4101.  
  4102.     This is a checkmarked menu sub-item.  When checked the minimum header
  4103.     lines will be included for the quoted message when composing a
  4104.     response.  If it is not checked, no header information will appear.
  4105.  
  4106.     The current state of this checkmarked item is saved in the aemail.cnfg
  4107.     file whenever the "Save Settings" menu item is selected.  It can also
  4108.     be set or reset by the General Parameters page on the Configuration
  4109.     screen.
  4110.  
  4111.  
  4112.  
  4113.                             Retrieve Msgs menu
  4114.                             ------------------
  4115.  
  4116. From POP Host
  4117.  
  4118.     This will only retrieve messages from the POP Server.  See the
  4119.     RETRIEVE MESSAGES command described previously in this
  4120.     document for a full explanation of the retrieval process.
  4121.  
  4122.     If your TCP/IP software is not active or connection to the
  4123.     POP Server can not be made, the RETRIEVE MESSAGES command
  4124.     will return silently with the information that the POP Server
  4125.     could not be reached in the title bar.
  4126.  
  4127. From Local File...
  4128.  
  4129.     This will only retrieve messages from a local file.  No attempt
  4130.     will be made to connect to the POP Server.  See the
  4131.     RETRIEVE MESSAGES command described previously in this
  4132.     document for a full explanation of the retrieval process.
  4133.  
  4134.     This menu sub-item allows you to retrieve messages from files
  4135.     even when online (connected to a host through your TCP/IP
  4136.     software).
  4137.  
  4138. Excl Dup Msgs
  4139.  
  4140.     This is a checkmarked menu sub-item.  When checked, duplicate
  4141.     messages (ones that were previously retrieved and stored in one
  4142.     of AEMail's folders), will not be stored.  See the description
  4143.     under the RETRIEVE MESSAGES command for the use and full explanation
  4144.     of the function of this item.
  4145.  
  4146.     The current state of this checkmarked item is saved in the aemail.cnfg
  4147.     file whenever the "Save Settings" menu item is selected.  It can
  4148.     also be set or reset by the General Parameters display on the
  4149.     Configuration screen.
  4150.  
  4151.  
  4152. Delete Host Mail
  4153.  
  4154.     This is a checkmarked menu sub-item.  When checked mail
  4155.     retrieved from your POP Server will be deleted after it is
  4156.     retrieved.  If it is not checked, mail will not be deleted
  4157.     and you will have to use the "Exl Dup Msgs" checkmark item
  4158.     discussed above to insure that a duplicate message are not
  4159.     retrieved the next time you retrieve messages.
  4160.  
  4161.     The current state of this checkmarked item is saved in the aemail.cnfg
  4162.     file whenever the "Save Settings" menu item is selected.  It can
  4163.     also be set or reset by the General Parameters display on the
  4164.     Configuration screen.
  4165.  
  4166.  
  4167.  
  4168.                                TCP/IP menu
  4169.                                -----------
  4170.  
  4171. Start Net
  4172.  
  4173.     This menu item makes connection to your Internet Provider.  It
  4174.     executes the script that has been assigned by the Start Net
  4175.     Tool Type or the TCP/IP page of the Configuration screen.  If
  4176.     no Start Net script has been assigned, the action that is
  4177.     performed is to iconify AEMail.  You can then perform the
  4178.     network connection in what ever manner was provided by your
  4179.     TCP/IP stack software.  Once the connection is made, un-iconify
  4180.     AEMail.
  4181.  
  4182.     When this menu item is selected and a "startnet" script has been
  4183.     assigned, the system will, by default, switch to the workbench
  4184.     screen and execute the "startnet" script.  This allows the initial
  4185.     dialing window to display.  Once your Internet connection has been
  4186.     made the system will switch back to the AEMail screen.
  4187.  
  4188.     You can control the switching to the workbench screen by a check-
  4189.     marked item in the TCP/IP Parameters page on the Configuration
  4190.     screen.
  4191.  
  4192.     If you are using AmiTCP, the script that should be run is
  4193.     AmiTCP:bin/startnet; although the user may specify a different script
  4194.     and path with the STARTNET Tool Type or in the TCP/IP Parameters page
  4195.     on the Configuration screen.
  4196.  
  4197.     If you are using Miami, a "startnet.miami" script has been provided
  4198.     for connecting with your Internet provider.  This is usually run from
  4199.     the AEMail program directory.  This is an AREXX script so you will
  4200.     have to precede the script name with "rx " (see Section IV,
  4201.     CONFIGURATION for setting up your Start Net script).  This is set up
  4202.     automatically with the AEMail install provided a Miami: assignment is
  4203.     in the system.
  4204.  
  4205.     If you are using a TCP/IP stack that does not have a Start Net script
  4206.     (such as TermiteTCP), you should be sure that the Start Net call
  4207.     gadget in the TCP/IP parameters page of the Configuration screen has
  4208.     been cleared.  Your Internet connection is then done manually as
  4209.     explained above.
  4210.  
  4211.     Once a connection is made to your Internet provider and you have
  4212.     returned to the AEMail screen, a connection will be made to your POP
  4213.     server to see if there are any messages available on the server.  If
  4214.     there are, the following requester will appear:
  4215.  
  4216.                   n Messages Available on the POP Server
  4217.  
  4218.                 Do you wish to receive these messages now?
  4219.  
  4220.     If you click on the [YES] button, those message will be retrieved at
  4221.     this point.  See the RETRIEVE MESSAGES command described in Section
  4222.     VI, COMMAND ICON STRIP above for details on this process.
  4223.  
  4224.     If you click on [NO], no message retrieval will take place at this
  4225.     time.  You will need to retrieve these messages later using the
  4226.     RETRIEVE MESSAGES command icon.
  4227.  
  4228.     After AEMail checks to see if any messages are available on the
  4229.     POP Server, it also checks to see if any messages are in the QUEUED
  4230.     folder (messages queued to be sent).  If there are, the following
  4231.     requester will appear:
  4232.  
  4233.                   You have n messages queued to be sent
  4234.  
  4235.                  Do you wish to send these messages now?
  4236.  
  4237.     If you click on the [YES] button, all of the messages in the QUEUED
  4238.     folder will be sent immediately. If you click on [NO], the queued
  4239.     messages will not be sent.
  4240.  
  4241.     After the connection is made, the following message will be displayed
  4242.     in the screen's title bar:
  4243.  
  4244.         TCP/IP Session started with [your-domain-name].
  4245.  
  4246.     If for any reason the connection can not be made, the following
  4247.     message will be displayed in the screen's title bar:
  4248.  
  4249.         TCP/IP connection to [your-domain-name] failed.
  4250.  
  4251.     The "Start TCP/IP Network Connection" command icon will perform the
  4252.     same operation as the "Start Net" menu item.
  4253.  
  4254. Stop Net
  4255.  
  4256.     This menu item terminates the connection to your Internet Provider.
  4257.     It executes the script that has been assigned by the Stop Net Tool
  4258.     Type or the TCP/IP page of the Configuration screen.  If no Stop Net
  4259.     script has been assigned, the action that is performed is to iconify
  4260.     AEMail.  You can then terminate the network connection in what ever
  4261.     manner was provided by your TCP/IP stack software.  Once the
  4262.     connection is terminated, un-iconify AEMail.
  4263.  
  4264.     When this menu item is selected and a "stopnet" script has been
  4265.     assigned, the system will terminate the connection silently in
  4266.     the background.  Since no action is required by the user (unlike
  4267.     "startnet"), the screen display will remain on the AEMail screen.
  4268.  
  4269.     If you want to switch to the Workbench screen while the connection is
  4270.     being terminated, you can do this through a check-marked item in the
  4271.     TCP/IP Parameters page on the Configuration screen.
  4272.  
  4273.     If you are using AmiTCP, the script that should be run is
  4274.     AmiTCP:bin/stopnet; although the user may specify a different script
  4275.     and path with the STOPNET Tool Type or in the TCP/IP Parameters page
  4276.     on the Configuration screen.
  4277.  
  4278.     If you are running Miami, a "stopnet.miami" script has been provided
  4279.     for terminating the connection with your Internet provider.  This
  4280.     script is usually run from the AEMail program directory.  This is an
  4281.     AREXX script so you will have to precede the script name with "rx "
  4282.     (see Section IV, CONFIGURATION for setting up your Stop Net script).
  4283.     This is set up automatically with the AEMail install provided a Miami:
  4284.     assignment is in the system.
  4285.  
  4286.     If you are using a TCP/IP stack that does not have a Stop Net script
  4287.     (such as TermiteTCP), you should be sure that the Stop Net call gadget
  4288.     in the TCP/IP parameters page of the Configuration screen has been
  4289.     cleared.  Your Internet connection is then terminated manually as
  4290.     explained above.
  4291.  
  4292.     The following messages will be displayed in the screen's title bar
  4293.     when the connection is terminated:
  4294.  
  4295.         TCP/IP session with [your-domain-name] terminated.
  4296.  
  4297.     The "Terminate TCP/IP Network Connection" command icon will perform
  4298.     the same operation as the "Stop Net" menu item.
  4299.  
  4300. TCP Logging File
  4301.  
  4302.     This has three submenu items for controlling your TCP Logging file.
  4303.     Please read Section IX. AEMAIL FILES, TCP Trace Log File for how to
  4304.     read the entries in this file.
  4305.  
  4306.     The sub-menu items are:
  4307.  
  4308.     Active
  4309.  
  4310.         This is a checkmarked menu sub-item which indicates whether the
  4311.         TCP Logging is active or not.  If a TCP Logging File has not been
  4312.         defined with the Configuration screen, this sub-item is ghosted.
  4313.  
  4314.         Clicking on this item when it is not checkmarked will activate TCP
  4315.         Logging.  Clicking on it when it is checkmarked will deactivate
  4316.         logging.
  4317.  
  4318.     Purge
  4319.  
  4320.         This is a handy way to delete all previous TCP Logging entries.
  4321.         "Purge" will delete the current logging file and open another file
  4322.         with the same name if logging is active.  If logging is not
  4323.         active, the current logging file will be deleted, but a new file
  4324.         will not be opened until the Active sub-item is checkmarked.
  4325.  
  4326.         This menu item can be used whether the logging file is currently
  4327.         active or not.
  4328.  
  4329.     Display/Edit...
  4330.  
  4331.         "Display/Edit" will call your editor to display the current TCP
  4332.         logging file.  The logging file MUST NOT be Active in order to
  4333.         display or edit it.  If it is active you will get a requester that
  4334.         informs you that you can't display the file beause it is active.
  4335.         If this happens, de-activate it by turning off the Active
  4336.         checkmark and then try the "Display/Edit" again.
  4337.  
  4338.         If a TCP Logging file has not been defined in the Paths page of
  4339.         the Configuration screen, you will receive a requester saying that
  4340.         it is not present.
  4341.  
  4342.         NOTE:  The TCP logging file can become quite large and it may take
  4343.         some time for your editor to bring in the file.  Some editors are
  4344.         slower than others in this regard.  If you are using the AmigaDos
  4345.         editor (Ed), you will see a series of astericks (@) moving across
  4346.         the screen as the file is being read in.  You might want to
  4347.         periodically purge the file (if it is always active), to prevent a
  4348.         very large TCP Log file from being created.
  4349.  
  4350.  
  4351.  
  4352.                            VIII. AEMAIL WINDOWS
  4353.  
  4354.                            Configuration Screen
  4355.                            --------------------
  4356.  
  4357. See Section IV. CONFIGURATION for a description of the Configuration
  4358. Screens.
  4359.  
  4360.  
  4361.                             Folder List Window
  4362.                             ------------------
  4363.  
  4364. The Folder List window will be displayed in the lower portion of the
  4365. screen when AEMail is first loaded and whenever you click on the DISPLAY
  4366. FOLDER LIST icon in the Command Icon Strip.
  4367.  
  4368. The Folder List window looks like the following:
  4369.  
  4370. =====================================================================
  4371.  
  4372.                             Folder List
  4373.  
  4374. Name      Description of Folder                     Not Read Total
  4375. ---------------------------------------------------------------------
  4376. INBOX     Messages Received                            nnnnn nnnnn| |
  4377. PENDING   Messages composed and pending for action           nnnnn| |
  4378. QUEUED    Messages Queued to be sent                         nnnnn| |
  4379. SENT      Messages that have been sent                       nnnnn| |
  4380. xxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nnnnn nnnnn| |
  4381. xxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nnnnn nnnnn| |
  4382.                                                                   | |
  4383. =====================================================================
  4384.  
  4385. The folder list is a scrolling list.  Double clicking on any of the
  4386. folders in the list will bring up the Message List window for that folder.
  4387. If the Folder Icon strip is also being displayed, double clicking on any
  4388. particular folder icon will also bring up the message list for that
  4389. folder.
  4390.  
  4391. If there are too many folders to fit in the window, you can scroll the
  4392. list by using the scroll bar, clicking on the up or down arrows below the
  4393. scroll bar, or by using the up or down cursor keys.
  4394.  
  4395. Additionally the following keys can be used to move the list as follows:
  4396.  
  4397.     "Home" or "Cursor Left" moves the listview to the top.
  4398.     "End" or "Cursor Right" moves the listview to the botton.
  4399.     "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  4400.         top line of the previous page will be displayed as the bottom
  4401.         line of the new page.
  4402.     "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  4403.         The bottom line of the previous page will be displayed as the
  4404.         top line of the new page.
  4405.     The cursor up/down keys on the keypad will have the same action as
  4406.         the normal cursor keys with the exception of the shift
  4407.         feature.
  4408.  
  4409. Single clicking on a item in the list or folder icon merely selects that
  4410. folder.  The selected folder is then the folder referenced by the Folders
  4411. Menu group items (Edit.., Delete..., Set Sort Key ...) and by such
  4412. commands as Message Delete, Message Copy, Message Transfer, or Message
  4413. Select All/NONE.
  4414.  
  4415. One of the folders is always active (selected).  On program startup, the
  4416. active folder will be INBOX.  You can always tell the current active
  4417. folder by the depressed frame around the folder icon.
  4418.  
  4419.  
  4420.                            Message List Window
  4421.                            -------------------
  4422.  
  4423. The Message List window will be displayed in the lower portion of the
  4424. screen whenever you double click on either an item in the folder list or
  4425. one of the folder icons.
  4426.  
  4427. You can also bring up the current folder list by clicking on the
  4428. "Display Current Folder's Message List" command icon in the command icon
  4429. tool bar.  The previous and next folder's message list can also be
  4430. displayed from the command icon tool bar.
  4431.  
  4432. The Message List looks like the following:
  4433.  
  4434. ========================================================================
  4435.  
  4436.     Message List for [folder-name] Folder ([folder Description...])
  4437.  
  4438.  FLGS Date     Time  From           Size Subject       (nnn messages)
  4439. ------------------------------------------------------------------------
  4440.  NARF MM/DD/YY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  4441. *NARF MM/DD/YY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  4442.  . . . . .                                                           | |
  4443.  NARF MM/DD/YY HH:MM xxxxxxxxxxxxx xxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  4444.                                                                      | |
  4445. ========================================================================
  4446.  
  4447.  
  4448. The column header line displays the number of messages in the folder as
  4449. (nnn messages).  This is the total number of messages including those
  4450. marked for deletion.
  4451.  
  4452. The message descriptions are presented in a scrollable list.  You can
  4453. scroll the list by using the scroll bar, clicking on the up or down arrows
  4454. below the scroll bar, or by using the up or down cursor keys.
  4455.  
  4456. Additionally the following keys can be used to move the list as follows:
  4457.  
  4458.     "Home" or "Cursor Left" moves the listview to the top.
  4459.     "End" or "Cursor Right" moves the listview to the botton.
  4460.     "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  4461.         top line of the previous page will be displayed as the bottom
  4462.         line of the new page.
  4463.     "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  4464.         The bottom line of the previous page will be displayed as the
  4465.         top line of the new page.
  4466.     The cursor up/down keys on the keypad will have the same action as
  4467.         the normal cursor keys with the exception of the shift
  4468.         feature.
  4469.  
  4470.  
  4471. The meaning of the various fields of each message description are as
  4472. follows:
  4473.  
  4474.     FLGS:   (starts in the 2nd column)
  4475.             N indicates an unread message
  4476.             A indicates a message with attachments (NOT IMPLEMENTED)
  4477.             R indicates the message is a reply
  4478.             F indicates the message is a forwarded message.
  4479.             D (in the same position as N) indicates the message is
  4480.               a deleted message.
  4481.  
  4482.     Date:   This is the message date from the DATE:  header in the form of
  4483.             MM/DD/YY (2 digit month, 2 digit day, and the last 2 digits of
  4484.             the year).
  4485.  
  4486.     Time:   This is the time the message was received in the form of HH:MM
  4487.             (2 digit hour, 2 digit minute).  Time uses a 24 hour clock.
  4488.  
  4489.     From:   Is the Real Name (if present) from either the From:  or To:
  4490.             header.  If the folder represents messages being sent from
  4491.             AEMail (PENDING, QUEUED, SENT) then this field will be headed
  4492.             "To" and the To:  header will be used.  If the Real Name is
  4493.             not present in the header, then the UserID will be used
  4494.             instead.  If a Nickname is being used for a message being
  4495.             sent, then the Nickname will appear.
  4496.  
  4497.     Size:   This is the size, in bytes, of the message in the form nnn,nnn.
  4498.             If the size exceeds 999,999 bytes then ***,*** will appear.
  4499.             The size includes the size of the message with all its
  4500.             attachments.
  4501.  
  4502.     Subject:  Up to 39 characters from the Subject:  header after RE:  and
  4503.             (fwd) are stripped.  You can tell if the message is forwarded
  4504.             or is a reply by examining the FLGS field.  RE:  and (fwd) are
  4505.             stripped from the Subject:  header to allow sorting to place
  4506.             all messages with the same subject (whether original, replied,
  4507.             or forwarded) together.  You can also control where 'replied'
  4508.             and 'forwarded' messages go in the list since these use
  4509.             separate sorting criteria.
  4510.  
  4511. An asterick (*) in the first position indicates that the message is
  4512. selected.  This position will be blank if the message is not selected.
  4513.  
  4514. The Message list can be sorted under a number of different categories (see
  4515. Set Sort Keys window below).
  4516.  
  4517. Double clicking on any message in the message list will bring up the
  4518. message display window for that message.
  4519.  
  4520. A single click will highlight and select the message.  An asterick will
  4521. appear in the first column of the line indicating the message is selected.
  4522. You can click on another message to highlight and select that message.
  4523. Clicking on a message that is already selected will deselect the message.
  4524.  
  4525. If you are running under AmigaDOS 3.0 or higher, you can also select (or
  4526. deselect) a group of messages by drag selecting.  Place the cursor over
  4527. the message you first want to select or deselect and then, holding down
  4528. the left mouse button, drag either up or down.  Whether selecting or
  4529. deselecting occurs depends on the state of the first message you select.
  4530.  
  4531. Only one message is highlighted.  If that message is selected it will be
  4532. considered the current message to reply to, forward, or edit when
  4533. composing messages.
  4534.  
  4535. Other operations such as DELETE/UNDELETE MESSAGE, SAVE/EXPORT MESSAGES,
  4536. COPY MESSAGE, TRANSFER MESSAGE, PRINT SELECTED MESSAGES, SEND MESSAGE
  4537. IMMEDIATELY, and QUEUE MESSAGE FOR LATER DELIVERY will use the entire
  4538. selected list of messages.
  4539.  
  4540.  
  4541.                        Folder Configuration Window
  4542.                        ---------------------------
  4543.  
  4544. The Folder Configuration window will be displayed over the entire screen
  4545. below the top title line when either the "New..." or "Edit..." menu items
  4546. are selected from the Folders menu.
  4547.  
  4548. The Folder Configuration window looks like the following:
  4549.  
  4550. =====================================================================
  4551.  
  4552.        Folder Name: [         ]   (1 - 9 Characters only) [SORT KEYS]
  4553.  
  4554. Folder Description: [            __                                 ]
  4555.                                 |  |___
  4556.          Tab Color: [@|  Red  | |______| [ ] Folder for Sent Messages
  4557.  
  4558.   =================================================================
  4559.   |Filter Parameters for Selecting Messages                       |
  4560.   =================================================================
  4561.   |                                                               |
  4562.   | [ ] Not [ ] Start Group                       [ ] Ignore Case |
  4563.   |                                                               |
  4564.   | For [@|    To:     ]               [@|   Contains    ] [] END |
  4565.   |                                                               |
  4566.   | Search [                                             ] [] AND |
  4567.   |                                                               |
  4568.   | [ ] End Group                                          [] OR  |
  4569.   |  ___________________________________________________________  |
  4570.   | |                                                         | | |
  4571.   | |                                                         | | |
  4572.   | |                                                         | | |
  4573.   | |                                                         | | |
  4574.   | |                                                         | | |
  4575.   | |                                                         | | |
  4576.   | |                                                         | | |
  4577.   | |                                                         |^| |
  4578.   | |_________________________________________________________|V| |
  4579.   |                                                               |
  4580.   |                            [ Add ] [Insert] [Modify] [Delete] |
  4581.   |                                                               |
  4582.   =================================================================
  4583.  
  4584.               [ SAVE ]                  [CANCEL]
  4585.  
  4586. ====================================================================
  4587.  
  4588. If you are editing an existing folder, the Folder Name will be filled in,
  4589. but the string gadget will be disabled.  You will not be able to modify
  4590. it.
  4591.  
  4592. If you are creating a new folder you must name it with a 1 to 9 character
  4593. folder name.  This will appear below the folder icon in the folder strip
  4594. and in the folder list.
  4595.  
  4596. The [SORT KEYS] button is used to call the Set Sort Keys window (see
  4597. below) to set the sort keys for the folder.
  4598.  
  4599. The folder description can be up to 99 characters, but of course that many
  4600. characters will never appear anywhere.  Up to 52 characters will appear in
  4601. the folder list display under "Description of Folder".  This will also
  4602. appear in the contextual help line in the window bar preceded by "Folder
  4603. for"
  4604.  
  4605. The Tab Color is a cycle gadget with the following possible values:  Red,
  4606. Green, Blue, Yellow, Orange, Magenta, Brown, or Purple.  This provides a
  4607. color on the folder tab to help classify the folders according to the
  4608. user's preferences.  The actual tab color will be displayed to the right
  4609. of this cycle gadget.
  4610.  
  4611. The checkbox gadget marked "Folder for Sent Messages" is used to indicate
  4612. when a folder is for messages that have been sent or ready to be sent
  4613. rather than in-coming folders.  The PENDING, QUEUED, and SENT folders all
  4614. have this box checked.
  4615.  
  4616. The special window in the center of the Folder Configuration window is
  4617. used to set filter parameters for this folder.  A full description of how
  4618. this works is given below under "Filter Selection Window".  The filtering
  4619. parameters are used to distribute in-coming messages to various folders.
  4620. For the INBOX, these filters have a special meaning which will reject any
  4621. message meeting the filtering criteria.  The heading for the filtering
  4622. criteria for the INBOX will read "Filtering Parameters for Rejecting
  4623. Messages" instead of "Filtering Parameters for Selecting Messages".
  4624.  
  4625. Since filtering can only occur with in-bound messages, folders for sent
  4626. messages can not have filtering parameters associated with them.  For all
  4627. folders for "sent" messages, all of the gadgets in the filtering window
  4628. will be disabled preventing the entry of any filtering information.  This
  4629. is true of the PENDING, QUEUED, and SENT folders as well as any folders that
  4630. have been added with the "Folder for Sent Messages" box checked.
  4631.  
  4632. Finally, you are given the choice of canceling the operation or saving the
  4633. folder data in the folder.config file with the [CANCEL] and [SAVE]
  4634. buttons.
  4635.  
  4636.                          Filter Selection Window
  4637.                          -----------------------
  4638.  
  4639. The filter selection window for setting filter parameters looks like this:
  4640.  
  4641.     =================================================================
  4642.     |Filter Parameters for Selecting Messages                       |
  4643.     =================================================================
  4644.     |                                                               |
  4645.     | [ ] Not [ ] Start Group                       [ ] Ignore Case |
  4646.     |                                                               |
  4647.     | For [@|    To:     ]               [@|   Contains    ] [] END |
  4648.     |                                                               |
  4649.     | Search [                                             ] [] AND |
  4650.     |                                                               |
  4651.     | [ ] End Group                                          [] OR  |
  4652.     |  ___________________________________________________________  |
  4653.     | |                                                         | | |
  4654.     | |                                                         | | |
  4655.     | |                                                         | | |
  4656.     | |                                                         | | |
  4657.     | |                                                         | | |
  4658.     | |                                                         | | |
  4659.     | |                                                         | | |
  4660.     | |                                                         |^| |
  4661.     | |_________________________________________________________|V| |
  4662.     |                                                               |
  4663.     |                            [ Add ] [Insert] [Modify] [Delete] |
  4664.     |                                                               |
  4665.     =================================================================
  4666.  
  4667. The gadgets in the top half of the window are used to enter filtering
  4668. parameters.  The first two checkmark gadgets ([ ] Not, [ ] Start Group)
  4669. and the [ ] End Group checkmark gadget at the bottom of the group are
  4670. currently disabled.  They are designed to be used for advanced selection
  4671. criteria that will be added to a future version of AEMail.
  4672.  
  4673. The cycle gadget which is prefaced with "For" is used to select the header
  4674. that you want to check.  This gadget has the following states:
  4675.  
  4676.     To:
  4677.     From:
  4678.     Reply-To:
  4679.     Subject:
  4680.     cc:
  4681.     bcc:
  4682.     Date:
  4683.     Msg is Reply
  4684.     Msg w/Attachments
  4685.     Msg is Forwarded
  4686.     Other Message Hdrs      (Registered Users only)
  4687.     Message Body            (Registered Users only)
  4688.  
  4689. Note: it is unlikely that you would see the bcc: header in an incoming
  4690. message even though it is contained in the header list.
  4691.  
  4692. To the right of this is a cycle gadget which specifies the condition this
  4693. header will be checked for.  For the To:, From:, Reply-To: Subject:, cc:,
  4694. and bcc:  headers, Other Message Hdrs, and Message Body the condition can
  4695. be either:
  4696.  
  4697.     Contains, or
  4698.     Does Not Contain
  4699.  
  4700. For the Date: header it can be one of the following conditions:
  4701.  
  4702.     Equal
  4703.     Not Equal
  4704.     Greater Than
  4705.     Greater Than / Equal
  4706.     Less Than
  4707.     Less Than / Equal
  4708.  
  4709. and for Msg is Reply, Msg w/Attachments, Msg is Forwarded it can be:
  4710.  
  4711.     Is Present
  4712.     Is Not Present
  4713.  
  4714. The argument to be searched against is entered into the string gadget that
  4715. is titled "Search".  For the To:, From:, Reply-To:, Subject:, cc:, and
  4716. Bcc: headers and the "Other Message Hdrs" and "Message Body" you can
  4717. enter an argument that has wild cards.  The wild cards that are used are
  4718. as follows:
  4719.  
  4720.     ?   matches any single character.
  4721.     c*  matches zero or more occurances of character c.  If an unknown
  4722.         character is to be matched you can use ?*.
  4723.     c+  matches one or more occurances of character c (at least one
  4724.         occurance of c must be present).
  4725.     \?  matches the character ?.
  4726.     \*  matches the character *.
  4727.     \+  matches the character +.
  4728.  
  4729. Any other characters must match exactly (except that case can be ignored -
  4730. see below).  The match can occur anywhere in the header.  The following
  4731. are some examples of how the match occurs:
  4732.  
  4733.     abc     matches "abc", "abcdef", or "xxabc"
  4734.     ab*c    matches "ac", "abc", "abbc", or "abbbc", etc.  Characters may
  4735.             be present either before or after the match.
  4736.     ab+c    matches "abc", "abbc", or "abbbc", etc.  Characters may be
  4737.             present either before or after the match.  This will not match
  4738.             "ab+c".  You would have to use "ab\+c" for this to occur.
  4739.     ab?*    matches a substring starting with "ab" and ending with "c".
  4740.             Characters may be present either before or after the match.
  4741.     ab\*c   matches "ab*c" only.  However charcters may be either before
  4742.             or after the match.
  4743.  
  4744. WARNING:  Please pay particular attention to the characters +, ?, and *.
  4745. If any of these characters appear in the information to be matched, you
  4746. must use \+, \?, or \* in the argument if you want an exact match to
  4747. occur.
  4748.  
  4749. If "Other Message Hdrs" is used, you probably would want to use the Header
  4750. designation as part of the search argument.
  4751.  
  4752. Searching on header data will search the entire string of characters
  4753. contained within that header even though that header may span multiple
  4754. lines.  This means that if an address you want to locate is contained in
  4755. the nth line of the To: header, it will be found.
  4756.  
  4757. When searching data in the message body, the entire argument must be found
  4758. in a single line of the body.  If you are searching for a multiple word
  4759. phrase which may be broken up onto more than one line, you should specify
  4760. multiple arguments with AND separating the arguments.
  4761.  
  4762. If you want to ignore the case of the header or message body data when the
  4763. comparison is made check the "Ignore Case" item.  The "Ignore Case" item
  4764. will only ignore the case of the 26 alphabetic characters of the
  4765. American/English alphabet.  It will not ignore the case of special
  4766. characters used in forign alphabets although these special characters can
  4767. be used in the Search criteria.
  4768.  
  4769. The Search argument for the Date: header can be of one or two formats.
  4770. The first format is either:
  4771.  
  4772.     dd mmm yyyy or
  4773.     mmm dd yyyy
  4774.  
  4775. mmm is the three character month abbreviation:  jan, feb, mar, apr, may,
  4776. jun, jul, aug, sep, oct, nov, or dec.  You can enter either upper case,
  4777. lower case, or mixed case month abbreviations (i.e., jan, JAN, or Jan are
  4778. all o.k.).
  4779.  
  4780. dd is the numeric digits for the day of the month and yyyy must be the
  4781. full 4 digit year.  If you want any day of a particular month to be used,
  4782. leave off the dd parameter.  Likewise, using just the 4 digit yyyy will
  4783. accept any month and day for that year.
  4784.  
  4785. The absence of any of the elements of the date (mmm, dd, or yyyy) will
  4786. indicate that that particular element should not be checked.  As an
  4787. example:  if you want only messages for the month of September to be
  4788. placed in a particular folder you would enter:
  4789.  
  4790.     sep
  4791.  
  4792. by itself and the condition would be entered as "equal to".  This would
  4793. capture messages with a Date header of September of any year (Sep 1997,
  4794. Sep 1998, etc.).  If you were interested in messages with a Date:  header
  4795. of September of 1997 you would enter:
  4796.  
  4797.     sep 1997
  4798.  
  4799. An alternate method of entering the date would be:
  4800.  
  4801.     mm/dd/yy    or
  4802.     mm/dd/yyyy  or
  4803.     mm-dd-yy    or
  4804.     mm-dd-yyyy
  4805.  
  4806. mm is a one or 2 digit month (1 or 01 to 12), dd is a one or 2 digit day
  4807. (1 or 01 to 31) and yy is either a 2 digit or 4 digit year. 0 is invalid
  4808. for any of the mm, dd, or yy.  If you want to indicate the absence of any
  4809. of the elements use xx or XX.  As an example, to capture messages with a
  4810. Date header equal to any day within September 1997 you could enter:
  4811.  
  4812.     09/xx/97
  4813.  
  4814. Before the search for a Date: header is made, the date in the Date: header
  4815. is converted to an internal format.  The search argument is also converted
  4816. to this same internal format so that the match can be performed correctly.
  4817.  
  4818. The Search argument for Msg is Reply, Msg w/Attachments, and Msg is Forwarded
  4819. is ignored.
  4820.  
  4821. The "END", "AND, and "OR" gadgets are used to indicate that this is the
  4822. last comparison argument (END), or that there is another comparison
  4823. argument following this with either an AND or OR relationship.
  4824.  
  4825. Some examples of specific types of filtering parameters are given below.
  4826.  
  4827. The list view in the lower half of the window lists the comparison arguments.
  4828. Each comparison arguement is listed on two lines.  The first line shows
  4829. the header to be checked and the comparison criteria in the following
  4830. format:
  4831.  
  4832. FOR header-name comparison-criteria (ignoring case)
  4833.  
  4834. (ignoring case) will not be present if "Ignore Case" is not checked.
  4835.  
  4836. The second line will show the search argument surrounded by quote (")
  4837. marks.  It will be followed by AND or OR if either of these were
  4838. specified.  If "Ignore Case" was checked, the Search argument will be in
  4839. all lower case characters no matter how it was entered in the Search:
  4840. string gadget.
  4841.  
  4842. To add a selection criteria to the list, enter the appropriate items in
  4843. the gadgets at the top of the window and click on the [ Add ] gadget at
  4844. the bottom of the window.  That item will be transfered to the listview at
  4845. the end of the current list of items.
  4846.  
  4847. To modify or delete an item, click on the item in the listview.  Clicking
  4848. on either the first or second line of any item in the list is acceptable.
  4849. The information from the listview will be transferred to the gadgets at
  4850. the top of the window.  Then make the modifications you want (for modify)
  4851. and click on either the [Modify] or [Delete] gadgets at the bottom of the
  4852. window.
  4853.  
  4854. To insert an item into the list, enter the data in the gadgets at the top
  4855. of the window as you did to add an item.  This time click on the [Insert]
  4856. gadget.  The words "Click on item you want to insert IN FRONT OF!" will
  4857. appear in yellow at the top of the listview.  Now, as instructed, click on
  4858. the item you want the selection criteria to be inserted in front of.  This
  4859. allows you to insert at the head of the list by clicking on the first item
  4860. in the list.  Clicking on either the first or second line of any item in
  4861. the list is acceptable.
  4862.  
  4863. All of the selection criteria except for the last item must have an AND or
  4864. OR relationship to the criteria following.  You can have relationships as
  4865. follows:
  4866.  
  4867.     a OR b OR c
  4868.  
  4869. indicating that if any of the conditions (a, b, or c) are met that message
  4870. will be selected for that particular folder, or
  4871.  
  4872.     a AND b AND c
  4873.  
  4874. indicating that all of the conditions must be met for that message to be
  4875. selected.
  4876.  
  4877. Be careful of mixing AND and OR conditions.
  4878.  
  4879.     a OR b AND c
  4880.  
  4881. will work but
  4882.  
  4883.     b AND c OR a
  4884.  
  4885. will not work correctly.
  4886.  
  4887. Conditions are checked serially.
  4888.  
  4889. In the first example above, if condition a is not met, then b will be
  4890. checked.  If b is not met no selection is made; however, if condition c is
  4891. also met, the message will be selected.  If condition a is met the
  4892. message will be selected and the b or c conditions are not checked.
  4893.  
  4894. In the second example, if condition b is not met, no further check will be
  4895. made so that even if a is met, the message will not be selected.  In this
  4896. example condition a will never be checked.
  4897.  
  4898. Advanced selection is designed to get around this problem.  HOWEVER, THIS
  4899. ADVANCED SELECTION HAS NOT BEEN IMPLIMENTED AS YET!  AND WHEN IT IS
  4900. IMPLIMENTED, IT WILL ONLY BE AVAILABLE TO REGISTERED USERS.
  4901.  
  4902. With advanced selection you will be able to group items in this manner:
  4903.  
  4904.     (a AND b) OR (c AND d)
  4905.  
  4906. conditions a and b are a group and conditions c and d are a group.  The
  4907. checkmarked items "Start Group" and "End Group" are used to specify the
  4908. first item in a group and the last item in a group.  You will also be able
  4909. to embed groups within groups such as
  4910.  
  4911.     (a AND b AND (c OR d))
  4912.  
  4913. and use a not condition for a group such as
  4914.  
  4915.     (a AND b AND NOT (c OR d))
  4916.  
  4917. or simply
  4918.  
  4919.     NOT (a OR b)
  4920.  
  4921. Filtering Restrictions.  Currently the following restriction is placed on
  4922. filtering.  This restriction will be lifted in a later release of AEMail.
  4923.  
  4924. Advanced selection (grouping selection criteria as described above), can
  4925. not be done.
  4926.  
  4927. Other selection criteria (such as size of message) may be added later.
  4928.  
  4929.                    Examples of using Message Filtering
  4930.                    ===================================
  4931.  
  4932. How would you use message filtering?  Here is a practical example of how I
  4933. use it.  As you all know, when you implement a new version of AEMail and
  4934. send your first message a special notification message is sent to me
  4935. indicating the version you are using.  This notification message is stored
  4936. in a special folder for notification messages that I have received.  All
  4937. of the notification messages indicate what they are in the Subject:
  4938. header.  However, over the development of AEMail, the format of this
  4939. subject header has changed.  Before version 1.10 the Subject header looked
  4940. like this:
  4941.  
  4942.     Subject: Registration of AEMAIL (Amiga EMAIL), Version x.xx
  4943.  
  4944. From version 1.10 through version 1.15, the Subject header looked like
  4945. this:
  4946.  
  4947.     Subject: AEMAIL Version x.xx Registration
  4948.  
  4949. After version 1.15 the Subject header looked like this:
  4950.  
  4951.     Subject: AEMAIL Version x.xx Notification
  4952.  
  4953. Since I am still receiving notification messages back to version 1.03, I
  4954. wanted all such notification messages to go into the same folder.  The
  4955. selection criteria for this folder was set to the following:
  4956.  
  4957.     For Subject: Contains (ignoring case)
  4958.     "aemail version ???? registration" OR
  4959.  
  4960.     For Subject: Contains (ignoring case)
  4961.     "aemail version ?* notification" OR
  4962.  
  4963.     For Subject: Contains (ignoring case)
  4964.     "registration of aemail (amiga email), version"
  4965.  
  4966. Notice how I handled the variable of the version number in each case.  In
  4967. the first criteria I used a fixed replacement wild card (????) to specify
  4968. the version number.  In the second criteria I used a variable replacement
  4969. wild card (?*) and in the third criteria I did not use any wild card for
  4970. the version number replacement.  That is because the version number occurs
  4971. at the end of the line.
  4972.  
  4973. Another use of filtering can be used if you are subscribed to a listserve.
  4974. The example I will show you is for the Miami list serve.  Miami actually
  4975. has two listserves: "miami-talk-ml@nordicglobal.com" and
  4976. "miami-announce-ml@nordicglobal.com".  The To: address usually reflects
  4977. which listserve the message is coming from but the Reply-To: address
  4978. always reflects "miami-talk-ml@nordicglobal.com".
  4979.  
  4980. If you want the folder to include all messages from both listserves you
  4981. can set the following criteria for the that folder:
  4982.  
  4983.     For Reply-To: Contains (ignoring case)
  4984.     "miami-talk-ml@nordicglobal.com"
  4985.  
  4986. If you set up two folders, one for the "talk" message list and the other
  4987. for the "announcement" message list you could set the "talk" folder to
  4988. reflect the following criteria:
  4989.  
  4990.     For To: Contains (ignoring case)
  4991.     "miami-talk-ml@nordicglobal.com"
  4992.  
  4993. and the "announcement" folder as follows:
  4994.  
  4995.     For To: Contains (ignoring case)
  4996.     "miami-announce-ml@nordicglobal.com"
  4997.  
  4998. If messages meet the selection criteria for two different folders, the
  4999. first folder in the folder list which meets the criteria will be selected.
  5000. So, if you were to have two folders set up as described above (one for
  5001. "talk" messages and one for "announcement" messages) and you used the
  5002. Reply-To: address instead of the To: address as the selection criteria for
  5003. the "talk" folder and if the "talk" folder was first, all of the
  5004. "announcement" messages would go in the "talk" folder.  However, if the
  5005. "announcement" folder was first, then the messages would be distributed to
  5006. the correct folders.
  5007.  
  5008. You will find that the clipboard capability is very helpful in setting up
  5009. your filtering conditions.  If there is a particular header that you want
  5010. selected, display the message that has that header, and then double click
  5011. on the header in the message.  Edit out the header designator (To:, From:,
  5012. Subject:, etc) and save it to the clipboard.  You can save various items
  5013. changing the clipboard unit for each item.  Then when you are in the
  5014. Folder Configuration screen, select the Search string gadget and use Right
  5015. Amiga U to call up the clipboard list.  Then double click on the item you
  5016. want to select on.  It will then be automatically pasted into the Search
  5017. string gadget.
  5018.  
  5019. As was stated in the earlier description of the Filter Selection Window,
  5020. the window for the INBOX is used to EXCLUDE messages meeting the INBOX
  5021. criteria from entering your system.  Use this with CARE!  If you exclude a
  5022. message and you are deleting messages from you POP server, YOU WILL NEVER
  5023. SEE THAT MESSAGE!
  5024.  
  5025.  
  5026.                            Set Sort Keys Window
  5027.                            --------------------
  5028.  
  5029. The Set Sort Keys window will be displayed over the entire screen below
  5030. the top title line when either the "Set Sort Key..." menu item from the
  5031. Folders menu is selected or the [Sort Keys] button is clicked in the
  5032. Folder Configuration window.
  5033.  
  5034. The Set Sort Keys window looks like the following:
  5035.  
  5036. =====================================================================
  5037.  
  5038.                1       2       3       4       5       6       7
  5039. Priorities: ------- ------- ------- ------- ------- ------- -------
  5040.  
  5041. Un-Read Messages: FIRST [ ]      Messages with Attachments: FIRST [ ]
  5042. Priority [@|0|     LAST [ ]      Priority [@|0|              LAST [ ]
  5043.  
  5044. Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  5045. Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  5046.  
  5047. Latest Date:      FIRST [ ]      Largest Messages: FIRST [ ]
  5048. Priority [@|0|     LAST [ ]      Priority [@|0|     LAST [ ]
  5049.  
  5050. Group by FROM at Priority [@|0|    Group by Subject at Priority [@|0|
  5051.  
  5052. [ ] Order Received
  5053.                    --> at Priority [@|0|     [ ] Apply to all Folders
  5054. [ ] Latest Received
  5055.  
  5056. [LAST SAVED]    [LAST USED]    [   USE   ]    [  SAVE  ]   [ CANCEL ]
  5057.  
  5058. =====================================================================
  5059.  
  5060. Messages in each of the folders can be displayed in various sort orders
  5061. and each folder can have a different sort order.  Up to seven levels of
  5062. sort priority can be given.  The various sorting criteria are shown on
  5063. this window and a particular sort order can be given for any sort
  5064. priority.  The sorting criteria for any particular priority is selected by
  5065. the priority cycle gadget under or opposite each criteria.  A priority of
  5066. 0 is used to indicate that this criteria is not used in the sort.
  5067.  
  5068. To help visualize which criteria applies to which priority a list at the
  5069. top of the window shows the current position of any particular sort
  5070. criteria in the priority list.  With the exception of priority 0 (no
  5071. priority), no two criteria can have the same priority.  If this happens,
  5072. **DUP** will appear for that priority in the priority list.
  5073.  
  5074. If you want the sorting criteria to be used for all folders check the
  5075. "Apply to all Folders" box.
  5076.  
  5077. At the bottom of the window is the [LAST SAVED], [LAST USED], [USE],
  5078. [SAVE], and [CANCEL] buttons.  If you want the sorting to apply only to
  5079. this AEMail session only select [USE].  If you want to make the sorting
  5080. permanent, select [SAVE].  [CANCEL], of course, will abort the operation
  5081. without setting any sort keys.  The [LAST SAVED] button is used to restore
  5082. the sort keys to those last saved and the [LAST USED] is used to restore
  5083. the last used sort keys.
  5084.  
  5085. If the this window was called from the Folder Configuration Window,
  5086. selecting [USE], [SAVE], or [CANCEL] will return you to the Folder
  5087. Configuration Window.
  5088.  
  5089. The [LAST SAVED] and [LAST USED] buttons will simply restore the
  5090. appropriate sorting order and will not terminate the Folder Configuration
  5091. Window.  You will have to use the [USE], [SAVE], or [CANCEL] buttons to do
  5092. that.
  5093.  
  5094.                       Examples of Setting Sort Keys
  5095.                       =============================
  5096.  
  5097. You may want your messages displayed in different orders in the Message
  5098. List Window.  This is the purpose of the "Set Sort Keys Window."
  5099.  
  5100. Let's assume that you want your messages displayed with unread messages
  5101. first.  Within both the unread and previously read sections you want the
  5102. messages sorted by the latest date first.  To do this click on the Un-Read
  5103. Messages:  FIRST box and set the priority underneath Un-Read Messages to
  5104. 1.  Then click on the Latest Date:  FIRST box and set it's Priority to 2.
  5105. Notice that as you change the Priority cycle gadget for Latest Date from 0
  5106. to 1 to 2, you will see *DUP* appear in priority 1 as the Date moves
  5107. through the priority 1 position.
  5108.  
  5109. The final sort window for the above sorting priority will look like this:
  5110.  
  5111. =====================================================================
  5112.  
  5113.                1       2       3       4       5       6       7
  5114. Priorities:  UNREAD   DATE  ------- ------- ------- ------- -------
  5115.  
  5116. Un-Read Messages: FIRST [X]      Messages with Attachments: FIRST [ ]
  5117. Priority [@|1|     LAST [ ]      Priority [@|0|              LAST [ ]
  5118.  
  5119. Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  5120. Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  5121.  
  5122. Latest Date:      FIRST [X]      Largest Messages: FIRST [ ]
  5123. Priority [@|2|     LAST [ ]      Priority [@|0|     LAST [ ]
  5124.  
  5125. Group by FROM at Priority [@|0|    Group by Subject at Priority [@|0|
  5126.  
  5127. [ ] Order Received
  5128.                    --> at Priority [@|0|     [ ] Apply to all Folders
  5129. [ ] Latest Received
  5130.  
  5131. [LAST SAVED]    [LAST USED]    [   USE   ]    [  SAVE  ]   [ CANCEL ]
  5132.  
  5133. =====================================================================
  5134.  
  5135. When you are satisfied with the order click on [SAVE] to save this order
  5136. for this folder only.  If you want to use this order for all your folders
  5137. click on "Apply to all Folders" before clicking on [SAVE].
  5138.  
  5139.  
  5140. Another example might have the messages displayed with unread messages
  5141. first, followed by messages grouped by SUBJECT, and within the SUBJECT
  5142. grouping, by the latest date received.  This, in effect, creates a message
  5143. threading condition with like subjects grouped together.
  5144.  
  5145. To create this sort condition, click on the Un-Read Messages:  FIRST box
  5146. and set it's priority to 1.  Then set the "Group by Subject at Priority"
  5147. cycle gadget to 2.  Finally click on the Latest Date:  FIRST box and set
  5148. it's priority to 3.  The final sort window for this grouping would be:
  5149.  
  5150. =====================================================================
  5151.  
  5152.                1       2       3       4       5       6       7
  5153. Priorities:  UNREAD SUBJECT   DATE  ------- ------- ------- -------
  5154.  
  5155. Un-Read Messages: FIRST [X]      Messages with Attachments: FIRST [ ]
  5156. Priority [@|1|     LAST [ ]      Priority [@|0|              LAST [ ]
  5157.  
  5158. Replied Messages: FIRST [ ]      Forwarded Messages: FIRST [ ]
  5159. Priority [@|0|     LAST [ ]      Priority [@|0|       LAST [ ]
  5160.  
  5161. Latest Date:      FIRST [X]      Largest Messages: FIRST [ ]
  5162. Priority [@|3|     LAST [ ]      Priority [@|0|     LAST [ ]
  5163.  
  5164. Group by FROM at Priority [@|0|    Group by Subject at Priority [@|2|
  5165.  
  5166. [ ] Order Received
  5167.                    --> at Priority [@|0|     [ ] Apply to all Folders
  5168. [ ] Latest Received
  5169.  
  5170. [LAST SAVED]    [LAST USED]    [   USE   ]    [  SAVE  ]   [ CANCEL ]
  5171.  
  5172. =====================================================================
  5173.  
  5174. If you want the messages sorted with the earlier messages first within the
  5175. subject grouping, you would click on Latest Date:  LAST rather than Latest
  5176. Date:  FIRST.
  5177.  
  5178. Since the date sort is controlled by the local date and time that the
  5179. message was SENT, you might want to use the Order Received or Latest
  5180. Received instead of Latest Date.  Order Received will list the messages
  5181. with the oldest received first, while Latest Received will list the
  5182. messages with the newest received first.
  5183.  
  5184. You, of course, can set different sort orders for different folders.  In
  5185. this case select the folder you want to change the sort order on and DON'T
  5186. click on the "Apply to all Folders" checkmark gadget.
  5187.  
  5188.  
  5189.                            Address Book Window
  5190.                            -------------------
  5191.  
  5192. The Address Book window will be displayed in the lower portion of the
  5193. screen whenever you double click on the ADDRESS BOOK command icon or on
  5194. the [Call Address Book] button in the COMPOSE MESSAGE window (see below
  5195. under the COMPOSE MESSAGE window description).
  5196.  
  5197. If you have a non-interlaced screen (640 x 200), the display will cover
  5198. the folder strip to allow more room for the Address Book display.  With an
  5199. interlaced screen (640 x 400) you will be able to see the folder strip.
  5200.  
  5201. The Address Book window looks like the following:
  5202.  
  5203. =====================================================================
  5204. Address Book
  5205. =====================================================================
  5206.  
  5207. Nick Name: [        ] Address: [                   ] Select [@| To: |
  5208.  
  5209. Real Name: [                        ] Group [ ]  Send Header Only [ ]
  5210.  
  5211. Nickname Real Name               UserID (Address)          [x] Expand
  5212. ---------------------------------------------------------------------
  5213. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  5214. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx DISTRIBUTION LIST WITH n ENTRIES | |
  5215.                                  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  5216.                                  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  5217. ---------------------------------------------------------------------
  5218.  
  5219.   [ ADD ]     [MODIFY]      [DELETE]      [SELECT]      [ EXIT ]
  5220.  
  5221. =====================================================================
  5222.  
  5223. This window can be used to create, modify, or delete Address Book entries.
  5224. It can also be used to select a Nickname to be used as a recipient of a
  5225. message when composing messages.
  5226.  
  5227. Several of the Command icons remain active when you are displaying the
  5228. Address Book window, although there meaning maybe slightly changed.  These
  5229. are the DISPLAY NEXT MESSAGE icon, the DISPLAY PREVIOUS MESSAGE icon, the
  5230. DISPLAY NEXT FOLDER icon, the DISPLAY PREVIOUS FOLDER icon, the DISPLAY
  5231. CURRENT FOLDER icon, the PRINT icon, the DELETE icon, and the COMPOSE
  5232. MESSAGE icon.
  5233.  
  5234. The three fields of an address book entry are:  a one to eight character
  5235. Nickname, an individual's real name (up to 99 characters), and the address
  5236. of the individual (UserId and Domain in the form userid@domain) which is
  5237. limited to 70 characters.
  5238.  
  5239. Group lists can also be created which distributes a message to a number of
  5240. different individuals.  The group is identified with the heading
  5241. "DISTRIBUTION LIST WITH nnn ENTRIES" in the top most UserID field.  The
  5242. nnn indicates the number of entries in the group.  The UserID's for the
  5243. members of that list are shown in alphabetic order below that heading.  For
  5244. items in the distribution list, real UserIDs or Nicknames can be used.  An
  5245. item in the distribution list can even be another distribution list
  5246. identified by the Nickname for that group.  By clicking on the Checkmarked
  5247. item "Group", you can identify the entry as a group item.
  5248.  
  5249. The checkmarked item identified as "Send Header Only" is only active when
  5250. "Group" is checked.  If a checkmark is in the "Send Header Only" box, only
  5251. the group name will be sent in the To:  field when a message is sent to
  5252. the group; otherwise, every UserId in the group will be listed in the To:
  5253. header.  It is a good idea to check this item if you have large groups or
  5254. if you don't want the other members of the group to know all the members
  5255. of the group.
  5256.  
  5257. If a Nickname rather than a UserID is used in the group list Address
  5258. field, then, if a modification is made to the UserID of the Nickname, you
  5259. do not have to change the item in the Group list.  The modification will
  5260. be automatic when the group rather than the individual is selected.
  5261.  
  5262. When composing a message, a Nickname can be used to identify the recipient
  5263. of a message.  All Nicknames are expanded to Real Name and UserID when
  5264. mail is sent.
  5265.  
  5266. For registered users of AEMail, the checkmarked box to the far right of
  5267. the list heading labeled "Expand" is used to shrink or expand the group
  5268. entries in the list.  When this box is not checked, only the group heading
  5269. is displayed without the entries in the group showing.  When it is
  5270. checked, the groups are expanded to show all the members of the group.
  5271. When first displayed, this item will be checked.  However, the system
  5272. remembers the state of this checkmark so if you should shrink the groups,
  5273. the next time you select the Address Book only the group headings will be
  5274. displayed.
  5275.  
  5276. For un-registered users, this item will be checked and ghosted.  You will
  5277. not be able to shrink the groups.
  5278.  
  5279. Address Book entries are sorted by Nickname and group entries are
  5280. interspersed with single entries.  Also Real Names are presented as first
  5281. name followed by last name rather than last name, first name.
  5282.  
  5283. This is a scrolling list.  If there are too many entries to fit in the
  5284. window, you can scroll the list by using the scroll bar, clicking on the
  5285. up or down arrows below the scroll bar, or by using the up or down cursor
  5286. keys.
  5287.  
  5288. Additionally the following keys can be used to move the list as follows:
  5289.  
  5290.     "Home" or "Cursor Left" moves the listview to the top.
  5291.     "End" or "Cursor Right" moves the listview to the botton.
  5292.     "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  5293.         top line of the previous page will be displayed as the bottom
  5294.         line of the new page.
  5295.     "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  5296.         The bottom line of the previous page will be displayed as the
  5297.         top line of the new page.
  5298.     The cursor up/down keys on the keypad will have the same action as
  5299.         the normal cursor keys with the exception of the shift
  5300.         feature.
  5301.  
  5302. WARNING:  if you have selected one of the string gadgets for entering
  5303. data, the keys listed above will not work for scrolling the list.  You
  5304. will have to click outside of the string gadget to re-activate scrolling
  5305. with the cursor keys.
  5306.  
  5307. For adding entries to the Address Book, the entries at the top of the
  5308. window are used to place data in the various fields of the Address Book
  5309. entry.  If a message was selected when the address book was called, the
  5310. Real Name:, if present, and Address:  fields are filled in with
  5311. information from the Reply-To:  header of the message.  If the Reply-To:
  5312. header is not present, the From:  header will be used.  You can force the
  5313. From:  header to be used by holding down the shift key when you click on
  5314. the Address Book icon.
  5315.  
  5316. Please keep in mind that Reply-To:  addresses normally do not have real
  5317. names associated with them, but From:  addresses many times do.  If you
  5318. want the real name you may have to hold down the shift key when you click
  5319. on the Address Book icon.
  5320.  
  5321. If you access the Address Book from the Compose message window during a
  5322. "mailto:" call to AEMail, the userid from the "mailto:" will be placed in
  5323. the address field.  This allows you to assign a Nickname and Real Name to
  5324. this address and save it in your Address Book.
  5325.  
  5326. If you click on one of the entries in the list view, that entry will be
  5327. transferred to the Nickname:, Real Name:, and Address:  fields at the top
  5328. of the window.  If you click on a group entry line which has the Group
  5329. Nickname and "DISTRIBUTION LIST ..." in the address portion, only the
  5330. Nickname:  and the Group name (in the Real Name field) will be transferred
  5331. leaving any previous address in the Address field.  The "Group" box will
  5332. also be checked.  This facilitates adding items to a Group list.
  5333.  
  5334. When adding an entry to the address book, you must always enter a Nickname
  5335. and Address.  Real Name is optional, but recommended.
  5336.  
  5337. To add a group entry, the "Group" box must be checked.  Groups need a
  5338. Nickname that is unique (not the same as that used for an individual) and
  5339. should have a group description entered in the Real Name:  string gadget.
  5340. Group entries are entered one at a time.  The maximum number of entries
  5341. that can be added to a group is 3000.  When a message is sent to a group,
  5342. the message will be sent to a maximum of 50 recipients at a time.  This
  5343. takes care of problems when there is a limit on the number of recipient
  5344. addresses that a SMTP server can handle at a time.
  5345.  
  5346. After correctly filling in the top portion of the window, click on the
  5347. [ADD] button to add the item to the list.  Except for group Nicknames,
  5348. there can't be a duplicate Nickname when adding to the list.  An already
  5349. existing group Nickname will cause the entry to be added to that groups
  5350. distribution list.
  5351.  
  5352. To modify an entry, the Nickname for the entry must already exist in the
  5353. list.  You can not modify Nicknames.  If you need to do this, delete the
  5354. old entry and add a new one.  For individual entries, you can modify
  5355. either the Real Name:  or Address:  fields.  For group entries you can
  5356. only modify the Real Name:  field.  If you need to modify an address in
  5357. the distribution list, delete the old one and add a new one.
  5358.  
  5359. One of the reasons that Nicknames are preferred in distribution lists is
  5360. that, if you need to modify a user's address, you can do so by simply
  5361. modifying the Individual's entry.  The address in the group is then
  5362. automatically updated by reference.
  5363.  
  5364. Selecting one of the entries in the address list will move the data from
  5365. that entry to the fields at the top of the window.  Make the modifications
  5366. you want then click on the [MODIFY] button to make the modifications.
  5367.  
  5368. To delete an entry, select it in the list and then click on the [DELETE]
  5369. button.  You can also use the DELETE icon to do this.
  5370.  
  5371. The [SELECT] button is used only for one special purpose.  If the full
  5372. Address Book was called from a "mailto:" call to AEMail, this button is
  5373. used to select an address from the Address Book and place it in the
  5374. appropriate recipients address line while composing the message.  The
  5375. Address Book display is slightly different if it was not a "mailto:" call
  5376. (see below).
  5377.  
  5378. When you click on the [SELECT] button, the Address Book display is closed
  5379. and the COMPOSE MESSAGE window is re-activated.  To determine which header
  5380. field is to receive the address, the "Select" cycle gadget at the top of
  5381. the window is used.  There are three items for this gadget:  To:, cc:, and
  5382. bcc:.  Determine which field should receive the address and then click on
  5383. the [SELECT] button.  The Nickname for the selected item is transferred to
  5384. the appropriate field in the compose window.
  5385.  
  5386. If the Address Book was not called from the Compose window, the "Select"
  5387. cycle gadget will be ghosted and can not be used.  If the Address Book was
  5388. called from the COMPOSE MESSAGE window, clicking on one of the address
  5389. fields before calling the Address Book will automatically select the
  5390. appropriate field in the "Select" cycle gadget.
  5391.  
  5392. You can avoid using the [SELECT] button for returning to the COMPOSE
  5393. MESSAGE Window by double clicking on an item in the Address Book list
  5394. view.
  5395.  
  5396. If the Address Book was not called from the COMPOSE MESSAGE window,
  5397. instead of double clicking, the COMPOSE MESSAGE command icon can be
  5398. selected when in the Address Book window.  When this is done, the COMPOSE
  5399. MESSAGE window is activated for composing a new message with the selected
  5400. address field always being the To: field.  The selected address in the
  5401. Address Book will be moved to the To: field.
  5402.  
  5403. The [EXIT] button is used to exit from the Address Book window without
  5404. performing any address selection for a composed message.  You will need to
  5405. [EXIT] from the Address Book if you want to quit AEMail.
  5406.  
  5407. If the Address Book was called while displaying a message, clicking on the
  5408. DISPLAY NEXT MESSAGE or the DISPLAY PREVIOUS MESSAGE icons will
  5409. automatically exit from the Address Book and display either the next or
  5410. previous message in the currently displayed message list.
  5411.  
  5412. If you click on the DISPLAY NEXT FOLDER, the DISPLAY PREVIOUS FOLDER, or
  5413. DISPLAY CURRENT FOLDER icons, the Address Book will be closed and the
  5414. appropriate message list for the selected folder will be displayed.
  5415.  
  5416. If the PRINT icon is selected while you are displaying the Address Book,
  5417. you will get a printout of your complete address book.  All individual
  5418. entries will be displayed first followed by group entries.  Unless a group
  5419. is too large to fit on one page, an attempt will be made to ensure that a
  5420. group will be printed in it's entirety on a page.
  5421.  
  5422. When the Address Book is be called from the COMPOSE MESSAGE window and the
  5423. COMPOSE MESSAGE window was not activated during a "mailto:" call to
  5424. AEMail, the Address Book display will be slightly different.  It will look
  5425. like this:
  5426.  
  5427. =====================================================================
  5428. |+| Address Book For Compose
  5429. =====================================================================
  5430.  
  5431. Nickname Real Name               UserID (Address)          [ ] Expand
  5432. ---------------------------------------------------------------------
  5433. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  5434. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx DISTRIBUTION LIST WITH n ENTRIES | |
  5435. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx DISTRIBUTION LIST WITH n ENTRIES | |
  5436. xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx| |
  5437. ---------------------------------------------------------------------
  5438.  
  5439. Click on Address Book entry to transfer to [@| To: | field  [ CLOSE ]
  5440.  
  5441. =====================================================================
  5442.  
  5443. This is an abreviated window which does not have the string gadgets for
  5444. creating or deleting Address Book entries.  It is designed for selecting
  5445. addresses to transfer to the COMPOSE MESSAGE window only.  When you click
  5446. on an address in the window it will be transferred to the appropriate
  5447. field in the COMPOSE MESSAGE window as determined by the cycle gadget at
  5448. the bottom of the window.  There are three items for this gadget:  To:,
  5449. cc:, and bcc:  (the same as the "Select" cycle gadget in the full Address
  5450. Book window.  Select which field should receive the address and click on
  5451. the address in the Address Book.  You can select multiple addresses; the
  5452. window will not close until you click on either the Close gadget at the
  5453. top of the Address Book window or the [CLOSE] button at the bottom of the
  5454. window.  The Address Book window will also close if you double click on a
  5455. name (It will be transferred and then the window will close).
  5456.  
  5457. You can also select which field you want to receive the address by
  5458. clicking into the appropriate field in the COMPOSE MESSAGE window.  You
  5459. will see the cycle gadget switch to that field and the cursor will
  5460. disappear from the field since the Address Book window will again become
  5461. activated.
  5462.  
  5463. When the Address Book is called from the COMPOSE MESSAGE window it will be
  5464. in the un-expanded state.  If you are a registered user, you can expand
  5465. the group names by clicking on the "Expand" checkmark gadget to the right
  5466. of the listview headings.
  5467.  
  5468. You can also have the full Address Book display called from the COMPOSE
  5469. MESSAGE window by holding down the shift key when you click on the [Call
  5470. Address Book] gadget.
  5471.  
  5472. NOTE:  When AEMail is loaded it will automatically create an address book
  5473. entry for the Nickname AEMail with an address for my email address:
  5474. jzachar@calweb.com.  You can use this entry whenever you wish to report a
  5475. bug or send a message concerning AEMail to me.
  5476.  
  5477.  
  5478.                           Message Display Window
  5479.                           ----------------------
  5480.  
  5481. The Message Display window will be displayed in the lower portion of the
  5482. screen whenever you double click on a message in the message list window.
  5483. If you are already displaying a message, clicking on the NEXT or PREVIOUS
  5484. command icons will display either the NEXT or PREVIOUS message.
  5485.  
  5486. If you have a non-interlaced screen (640 x 200), the display will cover
  5487. the folder strip to allow more room for the message display.  With an
  5488. interlaced screen (640 x 400) you will be able to see and use the folder
  5489. strip.
  5490.  
  5491. To re-display the Message List, click on the "folder" icon on the Command
  5492. Icon Tool Bar or one of the folders in the folder icon bar (if visable).
  5493.  
  5494. The message is divided into two sections:  message header information,
  5495. which is always present, and a scrolling list that displays the message.
  5496. Header information will also be displayed in the scrolling message
  5497. listview, but only those header lines that you want displayed.
  5498.  
  5499. The message header portion of the screen is set up as follows:
  5500.  
  5501. From: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Date: DOW, MMM DD YYYY HH:MM:SS
  5502. To: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx [ATTACHMENT]
  5503. Subject: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  5504.  
  5505.  
  5506. The From:  and To:  fields will show the Real Name (if present) from the
  5507. appropriate header.  If the Real Name is not present in the header, then
  5508. the UserID will be used instead.  If a Nickname is being used for a
  5509. message being sent, then the Nickname will appear.
  5510.  
  5511. The Subject field will have the RE; or (FWD) preappended to the field for
  5512. messages that are REPLIES and/or are FORWARDED.
  5513.  
  5514. If the message has attachments, either MIME or UUENCODED, the [ATTACHMENT]
  5515. button will appear at the right of the To:  line.  If no attachments are
  5516. present this button will say [SAVE TEXT] instead.  Clicking on the [SAVE
  5517. TEXT] button will bring up the save text requester along side the [SAVE
  5518. TEXT] button which is described below under "Save Text Requester".
  5519.  
  5520. The complete message will be displayed in the message listview including
  5521. any text type attachments.  If the attachments are UUENCODED attachments
  5522. or are non-text type attachments, they will not be shown, but can be
  5523. retrieved by clicking on the [ATTACHMENT] button.  This will bring up an
  5524. attachment requestor which is described below under "Attachment
  5525. Requester".
  5526.  
  5527. Messages that are encoded with "Quoted-Printable" notation as well as text
  5528. messages encoded with encoded binary (BASE64) will be correctly displayed
  5529. as well.  Since these types of messages will be saved with their encoding
  5530. intact when saved using the SAVE MESSAGE icon or the "Export..." item
  5531. under the Messages menu, the [SAVE TEXT] gadget has been provided to save
  5532. message text correctly decoded for messages without attachments.  For
  5533. messages with attachments, the first entry in the Attachment list is the
  5534. body of messages itself.
  5535.  
  5536. The message display is a scrolling list.  There are four methods that you
  5537. can use to scroll the message:
  5538.  
  5539.     (1) Use the scroll bar to the right of the message.
  5540.  
  5541.     (2) Use the scroll arrows at the bottom of the scroll bar.
  5542.  
  5543.     (3) Use the up and down cursor keys.  You can also move the listview
  5544.         with other keys as follows:
  5545.  
  5546.         "Home" or "Cursor Left" moves the listview to the top.
  5547.         "End" or "Cursor Right" moves the listview to the botton.
  5548.         "PgUp" or "Shift Cursor Up" pages the listview one "page" up.  The
  5549.             top line of the previous page will be displayed as the bottom
  5550.             line of the new page.
  5551.         "PgDn" or "Shift Cursor Down" pages the list view one "page" down.
  5552.             The bottom line of the previous page will be displayed as the
  5553.             top line of the new page.
  5554.         The cursor up/down keys on the keypad will have the same action as
  5555.             the normal cursor keys with the exception of the shift
  5556.             feature.
  5557.  
  5558.     (4) click the mouse on the list display and while holding down
  5559.         the left mouse button, move above or below the display.
  5560.         When you lift up on the mouse button after the list
  5561.         starts to scroll, you can continue to scroll by moving
  5562.         the mouse up or down.  Clicking into the display will
  5563.         stop the scrolling action.
  5564.  
  5565. While messages are loaded into the listview, you will not see them until
  5566. they are completely read.  A busy pointer will be displayed until the
  5567. listview is completely built.
  5568.  
  5569. For un-registered users, the message display will be quite slow to load
  5570. although you will be able to see the message as it is being loaded into
  5571. the display.  If you want a faster display load, register AEMail!
  5572.                                                  ================
  5573.  
  5574. You can also edit and save lines from the message to the clipboard by
  5575. double clicking on any line in the message.  This will open a window at
  5576. the top of the screen for editing and saving the line to the clipboard.
  5577. See the section "Using the Clipboard with AEMail" under V. USING AEMAIL.
  5578.  
  5579.                            Save Text Requester
  5580.                            ===================
  5581.  
  5582. When you click on the [SAVE TEXT] button on the Message Display Window, a
  5583. a tiered set of five buttons will appear to the left of the [SAVE TEXT]
  5584. gadget that look like this:
  5585.  
  5586.                          [    VIEW   ]
  5587.                          [ SAVE FILE ]
  5588.                          [ SAVE CLIP ][SAVE TEXT]
  5589.                          [ CLIP UNIT ]
  5590.                          [   CANCEL  ]
  5591.  
  5592.  
  5593. Clicking on one of the buttons will perform the appropriate action as
  5594. described below.  With the exception of [CLIP UNIT], the buttons will
  5595. disappear at the completion of the action.
  5596.  
  5597.     [VIEW]
  5598.  
  5599.         This will display the message text with the program you selected
  5600.         in the "mailcap" file for the "text" MIME type.  If a program was
  5601.         not pre-defined for this MIME type, this button will be disabled
  5602.         (ghosted).  This option is given so that you can select special
  5603.         message display programs to display the message and perhaps
  5604.         perform special operations of the message.  As an example, you
  5605.         could specify an editor which would allow you to make
  5606.         modifications to the message and then save portions of it to a
  5607.         file or clipboard.
  5608.  
  5609.     [SAVE FILE]
  5610.  
  5611.         A file requester will pop up which allows you to select
  5612.         a file to save your message to.  If the message used a coding
  5613.         scheme such as quoted-printable or encoded binary it will be
  5614.         properly converted before it is saved.  The default directory
  5615.         designated to receive this text file is RAM:; however, you can
  5616.         change this with the file requester or set a different
  5617.         default with the Default Path Parameters display on the
  5618.         Configuration screen.
  5619.  
  5620.     [SAVE CLIP]
  5621.  
  5622.         If the text has an encoding type of 7-bit, 8-bit, or
  5623.         quoted-printable, you can save it to the current clipboard unit.
  5624.         If the text is encoded binary, this button will be ghosted.
  5625.  
  5626.     [CLIP UNIT]
  5627.  
  5628.         This will bring up the requester that allows you to change the
  5629.         current clipboard unit (see "Using the Clipboard with AEMail"
  5630.         under V. USING AEMAIL).
  5631.  
  5632.     [CANCEL]
  5633.  
  5634.         This gadget is provided to exit from the request without
  5635.         performing any action.
  5636.  
  5637.                            Attachment Requester
  5638.                            ====================
  5639.  
  5640. When you click on the [ATTACHMENTS] button on the Message Display Window,
  5641. an Attachment Requester will be displayed.  It looks like this:
  5642.  
  5643.       |============================================================|
  5644.       |o|  Attachment List                                         |
  5645.       |============================================================|
  5646.       |                MimeType/SubType          File Name         |
  5647.       | ========================================================== |
  5648.       | | 1  SHOWN     text/plain                              | | |
  5649.       | |    Description: (None)                               | | |
  5650.       | | 2  VIEWABLE  image/gif                 castle.gif    | | |
  5651.       | |    Description: Picture of a castle                  | | |
  5652.       | | 3  SAVE ONLY application/octet-stream  aemail.lha    | | |
  5653.       | |    Description: The AEMail archive                   | | |
  5654.       | ========================================================== |
  5655.       |                                                            |
  5656.       |   [    VIEW   ]       [VIEW & SAVE]        [ SAVE FILE ]   |
  5657.       |                                                            |
  5658.       |   [ SAVE CLIP ]       [ CLIP UNIT ]        [    EXIT   ]   |
  5659.       |____________________________________________________________|
  5660.  
  5661. This requester is initially placed at the top center of the window
  5662. partially obscuring the command and folder icons and the top portion of
  5663. the message.  You can drag the requester around the window to expose other
  5664. items of the display.  You can also use the scroll bar on the message
  5665. display listview to show different parts of the message; however, none of
  5666. the commands on the command or folder bar or the menu bar can be activated
  5667. until after you click on the [EXIT] button in the Attachment Requester.
  5668.  
  5669. The SHOWN designation is used for any attachment that is displayed in the
  5670. message window.  This is generally any attachment that has a MIME type of
  5671. text or message.  However, standard Mailcap entries have been included in
  5672. the Mailcap file to also display and save these attachments from the
  5673. Attachment window.
  5674.  
  5675. Any message with attachments will generally have one section (the initial
  5676. message) which is displayable text and will be shown as an attachment with
  5677. the SHOWN designation.  You will also be able to VIEW all SHOWN parts of
  5678. the message separably.  You will always be able to save any item in the
  5679. list in it's un-encoded form.
  5680.  
  5681. UUENCODED attachments will have the designation UUENCODED displayed in the
  5682. MIME types/subtypes field.
  5683.  
  5684. Any attachments that do not have a MIME type of text or message will have
  5685. either a VIEWABLE or SAVE ONLY designation.  The VIEWABLE designation is
  5686. used for those MIME types/subtypes which have a program designated in the
  5687. mailcap file for displaying this MIME type/subtype.  If no program is
  5688. designated for this MIME type/subtype the SAVE ONLY designator will appear
  5689. on the attachment line and the [VIEW] and the [VIEW & SAVE] buttons will
  5690. be disabled.
  5691.  
  5692. UUENCODED attachments are always SAVE ONLY attachments.
  5693.  
  5694. To select an attachment to view, view & save, or to save only, select the
  5695. appropriate attachment line in the list view gadget.  You can select the
  5696. main description line (with number, mime type, and filename) or the second
  5697. line with the "Description:" heading.
  5698.  
  5699. After selecting the attachment, the buttons below the listview will
  5700. perform the following actions:
  5701.  
  5702.     [VIEW]
  5703.  
  5704.         This will display the attachment with the program you
  5705.         selected in the "mailcap" file for this MIME type/subtype.
  5706.         If a program was not pre-defined for this MIME type/subtype
  5707.         this button will be disabled and you will not be able to
  5708.         display the attachment.  You will also see SAVE ONLY rather
  5709.         than VIEWABLE on the description of this attachment.
  5710.  
  5711.     [VIEW & SAVE]
  5712.  
  5713.         A file requester will pop up which allows you to select
  5714.         a file to save your attachment to.  The default directory
  5715.         designated to receive attachments is RAM:; however, you can
  5716.         change this with the file requester or set a different
  5717.         default with the Default Path Parameters display on the
  5718.         Configuration screen.
  5719.  
  5720.         If a file name was provided in either the Content-Type: or
  5721.         Content-Disposition: headers, the file name will be shown
  5722.         on the attachment description and will be pre-set as the
  5723.         filename in the file requester.  You can, of course, change
  5724.         this name if you wish.
  5725.  
  5726.         After the file is saved, the attachment will be displayed
  5727.         with the program you selected in the "mailcap" file.
  5728.  
  5729.         If a program was not pre-defined for this MIME type/subtype
  5730.         this button will be disabled and you will not be able to
  5731.         display the attachment.  You will also see SAVE ONLY rather
  5732.         than VIEWABLE on the description of this attachment.
  5733.  
  5734.  
  5735.     [SAVE FILE]
  5736.  
  5737.         A file requester will pop up which allows you to select
  5738.         a file to save your attachment to.  The default directory
  5739.         designated to receive attachments is RAM:; however, you can
  5740.         change this with the file requester or set a different
  5741.         default with the Default Path Parameters display on the
  5742.         Configuration screen.
  5743.  
  5744.         If a file name was provided in either the Content-Type: or
  5745.         Content-Disposition: headers or with the UUENCODED "begin"
  5746.         line, the file name will be shown on the attachment
  5747.         description and will be pre-set as the default filename
  5748.         in the file requester.  You can, of course, change this
  5749.         name if you wish.
  5750.  
  5751.         You will always be able to save any attachment even if it
  5752.         is SHOWN and a filename is not specified.
  5753.  
  5754.     [SAVE CLIP]
  5755.  
  5756.         If the attachment has an encoding type of 7-bit, 8-bit, or
  5757.         quoted-printable, you can save the attachment to the current
  5758.         clipboard unit.  If the attachment is not a text type attachment
  5759.         (encoded binary), this button will be ghosted.
  5760.  
  5761.     [CLIP UNIT]
  5762.  
  5763.         This will bring up the requester that allows you to change the
  5764.         current clipboard unit (see "Using the Clipboard with AEMail"
  5765.         under V. USING AEMAIL).
  5766.  
  5767.     [EXIT]
  5768.  
  5769.         After performing all the operations you wish for any
  5770.         particular attachment, click on this button to remove
  5771.         the Attachment Requester.  This requester also has a
  5772.         CLOSE gadget which you can also use to exit from the
  5773.         requester.
  5774.  
  5775.  
  5776.                           Compose Message Window
  5777.                           ----------------------
  5778.  
  5779. The Compose Message window is brought up whenever you click on the COMPOSE
  5780. MESSAGE command icon or select the Compose..., Reply..., or Forward...
  5781. sub-menus under the Messages menu.  If a message is selected when you
  5782. click on the COMPOSE MESSAGE command icon it will act as a "Reply to this
  5783. message" action.
  5784.  
  5785. The Compose Message window will cover the entire screen.  You must proceed
  5786. sequentional through the actions or cancel to abort the compose operation.
  5787.  
  5788. The Compose Message window looks like this:
  5789.  
  5790. =====================================================================
  5791. Compose a Message (Signature: [full path of signature file active])
  5792. =====================================================================
  5793.  
  5794.        To: [                              ][CLR] [Call Address Book ]
  5795.  
  5796.        cc: [                                                   ][CLR]
  5797.  
  5798.       bcc: [                                                   ][CLR]
  5799.  
  5800.  Reply To: [                                   ][CLR] [ Use Default ]
  5801.  
  5802.   Subject: [                                                   ][CLR]
  5803.  
  5804.            [] New Message                    [] 7-Bit
  5805.            [] Reply to Message               [] 8-bit
  5806.            [] Forward Message                [] quoted-printable
  5807.                                              [] encoded binary
  5808.  
  5809.  [ ] Quote Original Message Text   Quote Prefix[>                    ]
  5810.  
  5811.    Quote Header: [                                                   ]
  5812.  
  5813.  [ ] Add Signature Block   [Select Signature]        [ Edit Signature]
  5814.  
  5815.  [Compose/Edit Message]    [  Add Headers   ]        [Add Attachments]
  5816.  
  5817.  [Save In Pending] [Queue Message] [Send Message Now] [Cancel Message]
  5818.  
  5819. ======================================================================
  5820.  
  5821. The title bar on the Compose Message window will contain the full path
  5822. name to the current, in use signature file.
  5823.  
  5824. When the Compose Message window first appears and if the message is a
  5825. replied message, the following requester will appear if the replied
  5826. message had To:  recipients other than yourself:
  5827.  
  5828.  
  5829.        |=========================================================|
  5830.        | Multiple Recipients                                     |
  5831.        |---------------------------------------------------------|
  5832.        |             The message you are replying to             |
  5833.        |                has other To: recipients.                |
  5834.        |              Do you want to send the reply              |
  5835.        |                                                         |
  5836.        | [o] to only the sender of the original message?         |
  5837.        | [ ] to all To: recipients of the original message?      |
  5838.        | [ ] cc: to all To: recipients of the original message?  |
  5839.        | [ ] bcc: to all To: recipients of the original message? |
  5840.        |                                                         |
  5841.        |                       [ Continue ]                      |
  5842.        |                                                         |
  5843.        |=========================================================|
  5844.  
  5845. With this requester you can send the message you are composing to none of
  5846. the other recipients, directly to all the other recipients (in the To:
  5847. line), as a cc to all the recipients, or as a bcc to all the other
  5848. recipients.
  5849.  
  5850. If there is a single recipient to the message and that recipient is the
  5851. same as either your From:  or Reply-To:  address, you will not see the
  5852. requester.  Also, when the list of recipients is transferred to the
  5853. appropriate address line in the Compose window, any address that is the
  5854. same as your From:  or Reply-To:  address will be stripped.  If you want
  5855. to send the message also to the From:  or Reply-To: address you will have
  5856. to add the address yourself.
  5857.  
  5858. When you have selected the action you want, hit [Continue] and the list of
  5859. To: recipients will be transferred to the appropriate string gadget in
  5860. the Compose Message window.
  5861.  
  5862. SPECIAL CONSIDERATION:  If the message you are replying to was received by
  5863. a version of AEMail prior to 1.42, you will not be able to transfer
  5864. recipients that extend beyond one line.  You can solve this problem,
  5865. however, by saving the message you want to reply to to a file (using the
  5866. export function) and then reading it back into version 1.43 of AEMail.
  5867. To read it back in using the "From Local File.." menu item under the
  5868. "Retrieve Msgs" menu.
  5869.  
  5870. One point of warning.  If the recipient of the original message was the
  5871. name of a list rather than the name of an individual, you will also see
  5872. this requester.  Unfortunately, there is no way to know that the recipient
  5873. name is a list name rather than an individual name.  In this event, you
  5874. should always select "to only the sender of the original message" since
  5875. the list name is probably not a valid recipient.
  5876.  
  5877. If there were cc:'s to the original message, you may also see the
  5878. following similar requester for sending to the cc: recipients:
  5879.  
  5880.        |=========================================================|
  5881.        | Multiple Recipients                                     |
  5882.        |---------------------------------------------------------|
  5883.        |             The message you are replying to             |
  5884.        |             has one or more cc: recipients.             |
  5885.        |              Do you want to send the reply              |
  5886.        |                                                         |
  5887.        | [o] to only the sender of the original message?         |
  5888.        | [ ] to all cc: recipients of the original message?      |
  5889.        | [ ] cc: to all cc: recipients of the original message?  |
  5890.        | [ ] bcc: to all cc: recipients of the original message? |
  5891.        |                                                         |
  5892.        |                       [ Continue ]                      |
  5893.        |                                                         |
  5894.        |=========================================================|
  5895.  
  5896. Again, after you have selected the action you want, hit [Continue] and the
  5897. list of cc: recipients will be transferred to the appropriate string gadget
  5898. in the Compose Message window.
  5899.  
  5900. If the message is a replied message, the To: string gadget will also be
  5901. filled in with the Reply-To: address from the message you are replying to
  5902. or, if that is not present, the From: real name and user ID of the
  5903. message you are replying to.  This is in addition to any action caused by
  5904. the previously mentioned requesters.
  5905.  
  5906. You can force the From: address to be used by holding down the shift key
  5907. when clicking on the "compose" icon or selecting the menu sub-item "Use
  5908. From..." on the Reply menu item of the Messages menu.
  5909.  
  5910. Also, if the message is the result of a "mailto:" call, the To:  string
  5911. gadget will be filled in with the userid passed by the "mailto:" call.
  5912.  
  5913. If the message is a replied or forwarded message, the Subject:  string
  5914. gadget will be automatically filled in with the subject from the replied
  5915. or forwarded message.  RE:  or (fwd) will also automatically appear in
  5916. front of the subject.
  5917.  
  5918. You may enter names, either Nicknames or Real Names and/or UserIDs, for
  5919. any of the To:, cc:, or bcc:  fields.  If a Real Name and/or UserID is
  5920. entered, it should be entered as
  5921.  
  5922.         Real Name<userid@domain>              or
  5923.         userid@domain(Real Name)              or
  5924.         userid@domain
  5925.  
  5926. The domain can be left off if the recipient is at the same domain as the
  5927. user.  However, it is best that the full userid@domain be used so there is
  5928. no confusion with Nicknames.
  5929.  
  5930. If a Nickname is used it will be automatically expanded when the message
  5931. is sent.
  5932.  
  5933. If multiple users are placed in any of the To:, cc:, or bcc: fields they
  5934. must be separated by commas.  Each of the string gadgets (To:, cc:, or
  5935. bcc:) can hold a string up to 4096 charcaters long.  This allows you to
  5936. build up quite a long list of recipients; however, using a group Nickname
  5937. is preferable since only one name is needed in the string gadget.
  5938.  
  5939. If the users you are sending the message to are in your Address Book, you
  5940. can click on the [Call Address Book] button.  This will call up an
  5941. abreviated form of your Address Book (see Address Book window discussion
  5942. above) and you can select the user you want.  Clicking on the user will
  5943. transfer the Nickname for that user to the appropriate field indicated by
  5944. the cycle gadget at the bottom of the Address Book window (To:, cc:  or
  5945. bcc:).  The Nickname for the user will be automatically added to the
  5946. appropriate field in the Compose window.  If you make a mistake and the
  5947. wrong name is added or it is added to the wrong field, you can use the
  5948. backspace key to remove the offending nickname or the [CLR] gadget to
  5949. completely clear the field.
  5950.  
  5951. The Address Book window will remain displayed to allow you to select
  5952. multiple names.  Multiple names in any field will be automatically
  5953. separated by commas.
  5954.  
  5955. To exit from the Address Book display, either click on the Close gadget at
  5956. the top of the Address Book window or the [CLOSE] button at the bottom of
  5957. the window.  Alternately, you can double click on the last name you add to
  5958. a field.
  5959.  
  5960. You can also use the [Call Address Book] gadget to place the userid from a
  5961. "mailto:" call into your Address Book.  In this case the full address book
  5962. will be shown rather than the abbreviated one.  You can also access the
  5963. full Address Book by pressing the shift key when you click on the [Call
  5964. Address Book] gadget (see the discussion of the Address Book window
  5965. above).
  5966.  
  5967. All of the gadgets in the Compose Window remain active when you are
  5968. displaying the abbreviated form of the Address Book.  They are not active
  5969. when you display the full Address Book.  The "select" cycle gadget in the
  5970. Address Book can be used to select the field you want the address
  5971. transferred to, or alternately, you can click into the field you want and
  5972. the cycle gadget will automatically be set to that field.  When you do
  5973. this, the Address Book window will immediately become activated to allow
  5974. you to select the address you want or to move the Address Book list view
  5975. with the cursor keys.
  5976.  
  5977. The cc:  field is used to send a "carbon copy" of the message to the
  5978. people in the list on the cc:  line.  The cc:  header will appear on the
  5979. message sent to the To:, cc:  and bcc:  recipients.  The bcc:  field is
  5980. used the send a "blind carbon copy" to the people in that list.  The bcc:
  5981. recipients will not be identified to any of the recipients of the message.
  5982.  
  5983. The Reply To:  field is used to place a Reply-To:  address header in the
  5984. message.  This field is intended for people who want replies directed to a
  5985. different email address than their From:  address.  The configuration item
  5986. "Reply-To:" will automatically be loaded into this field when the compose
  5987. window is displayed.  If the Reply To:  address for this message should be
  5988. different than the configured Reply-To address, then place it here.  If
  5989. you click on the [ Use Default ] button, your configured Reply-To address
  5990. will be placed in this field.  If the Reply To:  field is left blank, no
  5991. Reply-To:  header line will be added to the message.
  5992.  
  5993. The Subject:  field is used to create a subject header for your message.
  5994. If the message is a reply, RE:  will be placed in front of the subject.
  5995. If the message is forwarded, (fwd) will be placed after the subject.
  5996.  
  5997. The [CLR] gadget to the right of the To:, Reply To:, Subject:, cc:, and
  5998. bcc:  string gadgets allows you to easily clear the data in the
  5999. appropriate string gadget.
  6000.  
  6001. Below the Subject field is two columns of Radio buttons for selecting the
  6002. type message to create and to specify the encoding method for the message
  6003. body.  The first column of radio buttons specifies the message type to
  6004. create.  These can be:
  6005.  
  6006.     Compose a new Message
  6007.     Reply to Message
  6008.     Forward Message
  6009.     Edit Message
  6010.  
  6011. Which buttons appear depends on the way the Compose Message window was
  6012. called.
  6013.  
  6014. "New Message" and "Edit Message" appear if a message was selected from the
  6015. PENDING or QUEUED folders and the COMPOSE MESSAGE command icon was
  6016. selected or the "Edit..." menu item was selected from the Messages menu.
  6017. The "Edit Message" button is initially highlighted.
  6018.  
  6019. "New Message", "Reply to Message", and "Forward Message" appear if a
  6020. message was selected from an input folder (such as INBOX) and the COMPOSE
  6021. MESSAGE command icon was selected or one of the "Reply" or "Forward..."
  6022. menu items were selected from the Messages menu.  If a "Reply" sub-menu
  6023. item was selected, the "Reply to Message" button will be initially
  6024. highlighted.  If "Forward..." is selected, the "Forward Message" button
  6025. will be intially highlighted.
  6026.  
  6027. Only "New Message" appears and is highlighted if no message was selected,
  6028. if the "Compose.." menu item was selected, or if a message in the SENT
  6029. folder was selected.
  6030.  
  6031. "New Message" also appears if the Compose message window was activated by
  6032. a "mailto:" call from a browser.  If a "message=" argument was provided on
  6033. the shell call to AEMail, both the "New Message" and "Edit Message" will
  6034. appear and the "Edit Message item will be highlighted..
  6035.  
  6036. If the "Edit...", "Reply" or "Forward..." menu items are selected and a
  6037. message was not selected, an error message appears.  If the "Compose..."
  6038. sub-menu is selected, a new message will always be created.  Likewise,
  6039. messages cannot be replied to or forwarded from the PENDING, QUEUED or
  6040. SENT folders.  If the "Edit..." menu item is selected, the message must
  6041. come from either the PENDING or QUEUED folder.
  6042.  
  6043. You can always change the preferred type of message to one of the other
  6044. ones allowed by clicking on the appropriate message type.
  6045.  
  6046. The radio button column on the right of the window is for the encoding
  6047. method for the message body.  Four items appear here:
  6048.  
  6049.     7-Bit
  6050.     8-Bit
  6051.     quoted-printable
  6052.     encoded binary
  6053.  
  6054. The default is 8-bit.  Some Internet gateways, however, can not handle
  6055. 8-bit data - only 7-bit.  If this is the case with your situation, select
  6056. 7-bit, or if your message contains characters above ASCII 128 (most
  6057. foriegn character sets have these types of characters), select
  6058. "quoted-printable" or "encoded binary".
  6059.  
  6060. The "quoted-printable" encoding is preferred in this instance.  You will
  6061. be able to read most of the raw message except for the extended character
  6062. set characters.  The "encoded binary" encoding will encode the message in
  6063. BASE64 encoding which is totally un-readable in it's raw format.  AEMail,
  6064. however, is able to handle the translation of both "quoted-printable" and
  6065. "encoded binary" in the message body for both sending and receiving
  6066. messages.
  6067.  
  6068. If the message is a reply, the "Quote Original Message Text" box will be
  6069. checked if you have selected this option in the General Parameters page of
  6070. the Configuration screen.  You can un-check this box if you don't want the
  6071. original text quoted in the message (or check it, if the default action
  6072. was not to include text).  For all other types of Compose windows, this
  6073. checkbox will be disabled.
  6074.  
  6075. The "Quote Prefix:" string gadget will indicate what is to be placed in
  6076. front of each quoted line.  This, by default, is '>'; however, you can add
  6077. whatever you like here (such as the person's initials followed by :  or
  6078. >).  You can also permanently change this field with the General
  6079. Parameters page of the Configuration screen.
  6080.  
  6081. A "Quote header:" will be placed on the line in front of the quoted
  6082. material.  Currently, the default header which will appear in the Quote
  6083. Header:  string gadget is:
  6084.  
  6085.     On &(week), &(date2), at &(time), &(name) wrote:
  6086.  
  6087. The & followed by a field name in parenthesis indicates substitution of
  6088. data from the original message headers.  The values that can be
  6089. substituted are:
  6090.  
  6091.     &(name)     The Real Name of the sender of the original
  6092.                 message.  If the Real Name is not available,
  6093.                 the sender's UserId will be used instead
  6094.  
  6095.     &(subject)  The subject from the original message.  Any RE:
  6096.                 or (fwd) will be stripped.
  6097.  
  6098.     &(week)     The day of the week that the original message
  6099.                 was sent.
  6100.  
  6101.     &(date)     The date the original message was sent in the form
  6102.                 DD MMM YYYY, where DD is the day of the month,
  6103.                 MMM is month in the form Jan, Feb, Mar, etc, and
  6104.                 YYYY is the full 4 digit year.
  6105.  
  6106.     &(date1)    Same as &(date).
  6107.  
  6108.     &(date2)    The date in the form MMM DD, YYYY.
  6109.  
  6110.     &(time)     The time the original message was sent in the
  6111.                 form HH:MM xM where HH is the hour on a 12 hour
  6112.                 clock, MM is the minute, and xM is AM or PM.
  6113.  
  6114.     &(to)       The email address the message was sent to.  For
  6115.                 mailing lists this could be the name of the mailing
  6116.                 list if that is what appeared in the To: header.
  6117.  
  6118. The "Quote Header" is designed to be modified by the user and can be
  6119. changed with the string gadget.  This change is only in effect for this
  6120. message however.  You can permanently change the "Quote Header" with the
  6121. General Parameters page of the Configuration screen.
  6122.  
  6123. Whether on not the quoted message's headers are to be included in the
  6124. quote is controlled by the "Incl Hdr in Resp" item under the Messages main
  6125. menu.  If this item is checked the "Date", "To", "From:", "Reply To:",
  6126. "Subject:", "cc:", and "bcc:" headers will be displayed from the original
  6127. message.  If it is not checked, no header information will be included.
  6128.  
  6129. The amount of header information in the quoted message is also controlled
  6130. by the "Display Full Hdr" item in the Messages menu.
  6131.  
  6132. The row of gadgets below the "Quote Header:" is used to specify
  6133. characteristics of your signature file if you want one.  They work in
  6134. conjunction with the full path name of your current active signature file
  6135. shown in the title bar of the Compose Message window.
  6136.  
  6137. If a signature file is present, the "Add Signature Block" box will be
  6138. checked and the path name of that signature file will appear in the title
  6139. bar.  If a signature file is not present, this checkbox will be disabled.
  6140. The default signature file is AEMail:.signature.  However, if you are a
  6141. registered user, you can change to any other signature file by clicking on
  6142. the [Select Signature] gadget.  This will call up a file requester in
  6143. which you can select the appropriate file.  The file does not have to
  6144. exist; you can create it with the [Edit Signature] gadget.
  6145.  
  6146. If you are an un-registered user, the [Select Signature] button will be
  6147. ghosted and you can only use the standard AEMail:.signature file.
  6148.  
  6149. If you want to create or edit the current selected signature file, you can
  6150. click on the [Edit Signature] button.  This will call up your editor to
  6151. allow you to create or edit the selected signature file.  After you have
  6152. edited or created your signature file in your editor, save the file and
  6153. exit from the editor.  This will return you to the COMPOSE MESSAGE window
  6154. and the "Add Signature Block" check box will be enabled.
  6155.  
  6156. If you do not want the signature block placed at the end of your message,
  6157. uncheck the Add Signature Block box.
  6158.  
  6159. Note:  if the message is being edited, the Add Signature Block box WILL
  6160. NOT be checked.  This is done to prevent two signature blocks being added
  6161. to the message.  However, rather than disable this item, it is left to
  6162. allow the user to add a signature block in the event one was not added to
  6163. the original message or you selected the "New Message" radio button.
  6164.  
  6165. The [Add Attachments] button brings up the Add Attachments Requster which
  6166. is described below.  This requester allows you to add one or multiple
  6167. files as attachments to your message.  You can bring up this requester at
  6168. any time.  If it is brought up a second time, the old attachment
  6169. information will appear in the attachment list.  You can add to this
  6170. information or delete entries as you desire.
  6171.  
  6172. The [Compose/Edit Message] gadget calls up the editor you specified in the
  6173. General Parameters page of the Configuration Screen.  If you are editing a
  6174. previously composed message, you will see that message in your editor
  6175. window.  You can make changes as appropriate.  Also, if you specified
  6176. "Quote Original Message Text" you will see the quoted text.  You can
  6177. delete and insert lines as appropriate.
  6178.  
  6179. One of the things you will NOT see in the editor window are your message
  6180. headers or the signature block unless it is an edited message.  The
  6181. signature block is always added after you compose the message.  If this is
  6182. a "new" message, you will see a blank editor screen when the editor is
  6183. first called.  Enter whatever text you wish to use in your editor's window
  6184. and then select "Save" and "Quit" from your editor's menus.  This will
  6185. return you to the Compose Message window.
  6186.  
  6187. You will not be able to edit or add headers when you [Compose/Edit
  6188. Message].  If you need to add additional headers to a message you can use
  6189. the [Add Headers] gadget to add the headers.  This feature is ONLY
  6190. available to registered users.  Un-registered users will find this gadget
  6191. ghosted.
  6192.  
  6193. Clicking on the [Add Headers] gadget will bring up the Add Headers window
  6194. which is very similar to the "Information" window for a icon which is
  6195. called from the Workbench menus.  The Add Headers window looks like this:
  6196.  
  6197.      |=============================================================|
  6198.      |[o]  Add Additional Headers                                  |
  6199.      |=============================================================|
  6200.      |                                                             |
  6201.      |         ====================================================|
  6202.      | Headers |                                                | ||
  6203.      |         |                                                | ||
  6204.      |         |                                                | ||
  6205.      |[ NEW  ] |                                                | ||
  6206.      |         ====================================================|
  6207.      |[DELETE] [                                                  ]|
  6208.      |                                                             |
  6209.      |     [ SAVE ]            [CLEAR ALL]              [CANCEL]   |
  6210.      |                                                             |
  6211.      |=============================================================|
  6212.  
  6213. Your additional headers will appear in the scrolling list.  To add a
  6214. header to the list, click on [NEW] and enter the complete header line in
  6215. the string gadget below the scrolling list.  Be sure and include the
  6216. header identifier as well as the header text.  To add this new header to
  6217. this list hit the [RETURN] key.  To transfer a header to the string
  6218. gadget for editing or deleting it, click on the header line in the
  6219. scrolling list.  Clicking on [DELETE] will then delete the header from the
  6220. list.  If you want to edit the header, make the changes you want and then
  6221. hit [RETURN].  When you are satisified with the headers you want to add,
  6222. click on [SAVE] and the new headers will be saved and added to your
  6223. message.  [CLEAR ALL] will clear all the headers from the list and
  6224. [CANCEL] will cancel the operations.
  6225.  
  6226. At the bottom of the Compose Window is a row of four action buttons as
  6227. follows:
  6228.  
  6229.  [Save In Pending] [Queue Message] [Send Message Now] [Cancel Message]
  6230.  
  6231. If you decide that you do not want to compose a message after
  6232. all, click on the [Cancel Message] button to exit the COMPOSE MESSAGE
  6233. window.
  6234.  
  6235. Otherwise, if all the correct information has been added in the
  6236. COMPOSE MESSAGE window, click on the appropriate action button
  6237. at the bottom of the window.  [Save In Pending] will save your newly
  6238. created message in the PENDING folder.  [Queue Message] will place the
  6239. message in the QUEUED folder and [Send Message Now] will send the message
  6240. provided that you are connected to you Internet Provider.  If you were
  6241. unsuccesful with sending the message, it will be stored in the QUEUED
  6242. folder to allow you to immediately send the message when you re-connect to
  6243. your Internet Service Provider.
  6244.  
  6245.                         Add Attachments Requester
  6246.                         =========================
  6247.  
  6248. When you click on the [ADD ATTACHMENTS] button on the Compose Message
  6249. Window, an Add Attachments Requester will be displayed which looks like
  6250. this:
  6251.  
  6252.      |=============================================================|
  6253.      |[o]  Add Attachments                                         |
  6254.      |=============================================================|
  6255.      |                                                             |
  6256.      |              Filename: [                              ][REQ]|
  6257.      |Attachment Description: [                                   ]|
  6258.      |  Content Type/SubType: [                                   ]|
  6259.      |                        =====================================|
  6260.      |                        | text/plain                      | ||
  6261.      |                        | text/enriched                   | ||
  6262.      |                        | text/richtext                   | ||
  6263.      |                        =====================================|
  6264.      |              Encoding: |@|           Plain Text            ||
  6265.      |                                                             |
  6266.      | Mime Type/Sub-Type   FileName                 Encoding      |
  6267.      |=============================================================|
  6268.      ||                                                         | ||
  6269.      ||                                                         | ||
  6270.      ||                                                         | ||
  6271.      ||                                                         | ||
  6272.      |=============================================================|
  6273.      |[  ADD ]         [DELETE]         [ APPLY ]         [CANCEL ]|
  6274.      |                                                             |
  6275.      |=============================================================|
  6276.  
  6277. The Filename string gadget should contain the FULL path name and filename
  6278. of the attachment.  Clicking on the [REQ] gadget will bring up a file
  6279. requester which will allow you to select the appropriate file.  The
  6280. filename portion of this string will be used as the "file=" parameter of
  6281. the Content-Type MIME header and as the "filename=" parameter of the
  6282. Content-Disposition MIME header.
  6283.  
  6284. The initial directory that is chosen for the file requester is the
  6285. directory that was set up in the "Add Attachment from Directory" string
  6286. gadget in the Configuration:  Default Path Parameters (see Configuration
  6287. Screen under IV.  Configuration above).  If you are adding multiple
  6288. attachments to the message, clicking on [REQ] will bring up the last
  6289. directory that you used.
  6290.  
  6291. If you enter a non-existant file, an error requester will be displayed
  6292. when you try to [ADD] the file to the attachment list.
  6293.  
  6294. The Attachment Description is an optional string gadget for entering a
  6295. description of the attachment.  If present, this string gadget will create
  6296. a Content-Description MIME header.
  6297.  
  6298. Content Type/SubType is a string gadget which contains the MIME Content
  6299. Type/Subtype entry which will appear on the Content-Type MIME header.
  6300. THIS IS A REQUIRED ENTRY UNLESS YOU ARE ADDING AN UUENCODED attachment.
  6301. It is not used for UUENCODED attachments.
  6302.  
  6303. A scrolling list below this gadget is used to select an appropriate
  6304. type/sub-type.  Predefined type/subtypes, as defined in RFC 1341 and
  6305. RFC 1521, are included in this list as follows:
  6306.  
  6307.     text/plain
  6308.     text/enriched
  6309.     text/richtext
  6310.     message/rfc822
  6311.     message/partial
  6312.     message/external-body
  6313.     multipart/mixed
  6314.     multipart/alternative
  6315.     multipart/digest
  6316.     multipart/parallel
  6317.     application/octet-stream
  6318.     application/postscript
  6319.     image/gif
  6320.     image/jpeg
  6321.     audio/basic
  6322.     video/mpeg
  6323.  
  6324. Also added to this list will be any additional type/subtypes added through
  6325. the mailcap file and any type/subtypes encountered when displaying
  6326. attachments during THIS RUN OF AEMAIL.  AEMail has no way to remember
  6327. differing type/subtypes that it encounters unless they are included in the
  6328. mailcap file.
  6329.  
  6330. You can also add your own type/subtype by directly entering it in the
  6331. Content Type/SubType string gadget.  Unless the type/subtype is well known
  6332. and published, you should pick one of the existing types (text/, message/,
  6333. application/, image/, audio/, or video/) and use a subtype beginning with
  6334. "x-".  As an example, you might want to define an IFF image (not part of
  6335. the mime published standard) as:
  6336.  
  6337.     image/x-iff
  6338.  
  6339. It is suggested that you use a mailcap entry for the image/x-iff to cause
  6340. it to permanently appear in the list of Content Type/Subtypes.
  6341. Attachments must be in the format you select.  AEMail will do no
  6342. conversion.  As an example, if you select application/postscript, the file
  6343. you attach should already be in postscript format.
  6344.  
  6345. Also, DO NOT use the follwing types/subtypes:
  6346.  
  6347.     message/partial
  6348.     message/external-body
  6349.     multipart/mixed
  6350.     multipart/alternative
  6351.     multipart/digest
  6352.     multipart/parallel
  6353.  
  6354. All of the multipart types are not supported except at the highest level
  6355. (specifying the initial attachment list), and this is done automatically
  6356. by the program.
  6357.  
  6358. The encoding cycle gadget has four states as follows:
  6359.  
  6360.     Plain Text
  6361.     Quoted-Printable
  6362.     Encoded Binary
  6363.     UUENCODED
  6364.  
  6365. Generally, "Plain Text" should be used for:
  6366.  
  6367.     text/
  6368.     message/
  6369.  
  6370. The exception to this is when the attachment contains characters outside
  6371. the range of ASCII 32 to ASCII 128 and you ISP can not handle 8-bit codes.
  6372. If the document you are attaching contains these characters (usually
  6373. present in documents using foriegn character sets), you should use
  6374. "Quoted-Printable" or "Encoded Binary" encoding.
  6375.  
  6376. Generally speaking "Encoded Binary" should be used for the following
  6377. types:
  6378.  
  6379.     application/
  6380.     image/
  6381.     audio/
  6382.     video/
  6383.  
  6384. "UUENCODED" should be selected if you want the attachment to be in
  6385. UUENCODED format.  You can not mix UUENCODED attachments with MIME
  6386. attachments!
  6387.  
  6388. When a type/subtype is selected, the appropriate encoding format is
  6389. automatically selected.  Of course, you can change this with the cycle
  6390. gadget if there is a need.
  6391.  
  6392. Once all of the attributes for any particular attachment are selected,
  6393. click on the [ADD] gadget to add the attachment to the attachment list.
  6394. If the Filename field or Content Type/Subtype field (other than for
  6395. UUENCODED attachments) is blank an error requester will appear indicating
  6396. that you must have a valid entry in these fields.  As many attachments as
  6397. you want can be added to this list, but you can not mix MIME type
  6398. attachments with UUENCODED attachments.
  6399.  
  6400. If you wish to delete any particular gadget, select the attachment from
  6401. the list and click on [DELETE].  There is no way to modify attachment
  6402. attributes once they have been added to the list.  If you want to do this,
  6403. first click on [DELETE], make the appropriate changes, and then click on
  6404. [ADD].
  6405.  
  6406. Once you are satisfied with your attachment list click on [APPLY].  The
  6407. Add Attachments Requester will disappear and the attachments will be
  6408. automatically added to your message after it is composed.
  6409.  
  6410. If you decide that you don't want to add attachments after all, click on
  6411. [CANCEL] and the attachments will not be added when you compose your
  6412. message.
  6413.  
  6414. Clicking on the Close Gadget at the top of the window has the same
  6415. effect as if you clicked on [CANCEL].
  6416.  
  6417. If you are editing a message which has attachments and you select the
  6418. [ADD ATTACHMENTS] button in the Compose Window and then decide you do not
  6419. want to change the attachments you have previously added, you should click
  6420. on [APPLY].  Clicking on [CANCEL] at this point will bring up a special
  6421. warning requester which says:
  6422.  
  6423.              Continuing will delete all previous attachments
  6424.                    Use APPLY if you wish to keep them.
  6425.  
  6426.              [CONTINUE]                  [APPLY ATTACHMENTS]
  6427.  
  6428. To keep the attachments you should click on [APPLY ATTACHMENTS].
  6429.  
  6430.                              IX. AEMAIL FILES
  6431.  
  6432. The following are the various files used by AEMail.  Normally, they all
  6433. reside in the AEMAIL:  directory with the exception of the aemail.cnfg
  6434. file, the TCPLOG file and the mailcap file.  The aemail.cnfg file normally
  6435. resides in the S:  directory, and both the TCPLOG file and the mailcap
  6436. file may or may not reside in the AEMAIL:  directory depending on the
  6437. user's preference.
  6438.  
  6439. You can override the AEMAIL:  assign by using the MAIL_DIR= Tool Type and
  6440. you can change the name an location of the aemail.cnfg file with the
  6441. CONFIG= Tool Type.
  6442.  
  6443. SPECIAL NOTE:  If the AEMAIL: assign is missing or is incorrect and you do
  6444. not have a MAIL_DIR= Tool Type, you will not be able to run AEMail.
  6445.  
  6446. With the exception of the mailcap file, you can begin AEMail without any
  6447. of the other files being present.  They will be automatically created as
  6448. you process messages or do other AEMail actions.
  6449.  
  6450. The mailcap file, if used, MUST be setup prior to executing AEMail.  This
  6451. can be done using any text editor.
  6452.  
  6453. The following are the AEMail files:
  6454.  
  6455.                                  mailcap
  6456.                                  -------
  6457.  
  6458. The mailcap file is used to establish programs that should be executed to
  6459. display MIME attachments.  Use of this file allows AEMail to use any
  6460. AmigaDOS operating system 2.1 or above.
  6461.  
  6462. The mailcap file is a standard Internet file which is specified in RFC
  6463. (Request For Comment) 1524.  Since it is standard, you can use a mailcap
  6464. file that was created for another program that specified a display program
  6465. for the same type of files.  That is the reason that AEMail allows you to
  6466. specify the directory that contains the mailcap file with the Tool Type
  6467. MAILCAP_DIR= or with the Configuration Screen.  If you do not include this
  6468. Tool Type or change the specification in the Default Path section of the
  6469. Configuration Screen, the mailcap directory will default to the AEMAIL:
  6470. directory.
  6471.  
  6472. AEMail only uses the two required fields of the RFC 1524 standard.  Other
  6473. fields are ignored at this time.
  6474.  
  6475. Each mailcap file consists of entries that describe the proper handling of
  6476. one media type at the local site.  A mailcap file consists of a sequence
  6477. of such individual entries separated by LINE FEEDS.  Blank lines and lines
  6478. starting with '#' are considered comments and are ignored.  Long entries
  6479. may be continued on multiple lines if the line to be continued ends with a
  6480. backslash character ('\').  In this event, mutiple lines are to treated as
  6481. a single mailcap entry.  Note that for such "continued" lines, the
  6482. backslash must be the last character of the line to be continued.
  6483.  
  6484. Each mailcap entry consists of a number of fields each separated by a
  6485. semicolon (';').  The first two fields are required, and must occur in the
  6486. specified order.  The remaining fields are optional and may appear in any
  6487. order.  NOTE:  At this time AEMail does not use these optional fields and
  6488. if they are present, ignores them.  Because of this, these optional fields
  6489. WILL NOT be discussed in this documentation.
  6490.  
  6491. The general format of a mailcap entry is:
  6492.  
  6493.     content type; view command [; ......] LINE FEED
  6494.  
  6495. The first field is the content type, which indicates the type of data this
  6496. mailcap entry describes how to handle.  It is to be matched against the
  6497. type/subtype specification in the "Content-Type" MIME header (see the ADD
  6498. ATTACHMENTS REQUESTER described in section VIII.  AEMAIL WINDOWS above).
  6499.  
  6500. If the subtype is "*", it is intended to match all subtypes of the named
  6501. content type.
  6502.  
  6503. Examples of the content type field are:
  6504.  
  6505.     images/gif
  6506.  
  6507. which is intended to match only the images/gif type/subtype whereas
  6508.  
  6509.     images/*
  6510.  
  6511. matches all image types (images/gif, images/jpeg, etc).
  6512.  
  6513. The second field, view command, is a specification of how the attachment
  6514. meeting the content type specification is viewed.  For any particular
  6515. operating system, this would indicate how the program is called.  For
  6516. AEMail this would include the entire path name for calling the program and
  6517. any parameters that are needed on the command line.  A "%s" is used to
  6518. indicate the substitution of the attachment name.  The entire entry should
  6519. be surrounded by quotes.  As an example:
  6520.  
  6521.     "sys:Utilities/multiview %s screen"
  6522.  
  6523. would call multiview placing the displayed attachment on its own screen
  6524. (the "screen" parameter).
  6525.  
  6526. If you needed to have the display on the Workbench screen you can add the
  6527. keyword "wb;" in front of the program path.  As an example, if you wanted
  6528. multiview to open on a window on the Workbench screen, you could use:
  6529.  
  6530.     "wb;sys:Utilities/multiview %s"
  6531.  
  6532. Note the use of the quotes (") surrounding the parameter.  This is
  6533. necessary so that the mailcap interpreter will be prevented from treating
  6534. special characters (such as ';') as part of the mailcap syntax.
  6535.  
  6536. Also note the absence of the "screen" keyword.  The above call would push
  6537. the Workbench screen to the front when MultiView was called and the
  6538. Workbench screen would be used for the MultiView window.  The only problem
  6539. with this is you would be limited to the number of colors and the
  6540. resolution specified for Workbench.  Some other programs, however, might
  6541. only be able to open as a window on the Workbench screen and would be
  6542. hidden by the AEMail screen when those programs were called unless the
  6543. "wb;" parameter was specified.
  6544.  
  6545. An example of a complete mailcap entry to use multiview to display all
  6546. images would be:
  6547.  
  6548.     image/*; "sys:Utilities/multiview %s screen"
  6549.  
  6550. Any image/ type, regardless of the subtype, would be displayed providing
  6551. there was an appropriate data type present for that image subtype.
  6552.  
  6553. A sample mailcap file is included with the archive which uses MultiView
  6554. for text, message, sound, image, and video files.  Since MultiView is a
  6555. 3.x program using datatypes, this mailcap file will ONLY work with 3.x
  6556. systems.  To make it work for 2.x systems, you would need to change the
  6557. display programs to your favorite programs that work with 2.x.  You might
  6558. also have to be specific as to the subtype for a specific display
  6559. type/subtype.  If you install AEMail on a 2.1 system using the provided
  6560. installation script, you will be able to create the mailcap file provided
  6561. you selected "Expert" mode for the installation "user mode".
  6562.  
  6563. The following is the sample mailcap file used for AmigaDos 3.x that uses
  6564. MultiView as the display agent.  Please note the use of the "screen"
  6565. parameter which tells MultiView to open on it's own screen rather than the
  6566. WorkBench screen.  This allows the use of all colors in the image's
  6567. palette.
  6568.  
  6569.     text/*;  "sys:Utilities/multiview %s"
  6570.     message/*; "sys:Utilities/Multiview %s"
  6571.     image/*; "sys:Utilities/multiview %s screen"
  6572.     audio/*; "sys:Utilities/multiview %s screen"
  6573.     video/*; "sys:Utilities/multiview %s screen"
  6574.  
  6575.  
  6576.                  General Configuration File (aemail.cnfg)
  6577.                  ----------------------------------------
  6578.  
  6579. The s:aemail.cnfg file is the General Configuration file.  This file
  6580. contains various configuration information including the version and
  6581. revision number of the AEMail version that was last loaded.  A special
  6582. flag in this file indicates whether this file should take precedence over
  6583. the Tool Type entries.
  6584.  
  6585. This file is normally placed in the S:  directory rather than the AEMAIL:
  6586. directory.  The reason for this was that if you changed the location of
  6587. the AEMAIL:  directory, AEMail would not be able to locate the new
  6588. configuration file the next time you loaded AEMail.  Also, the S:
  6589. directory is more commonly used to store configuration files for AMIGA
  6590. programs.
  6591.  
  6592. You do not have to store this file in the S:  directory nor do you have to
  6593. name it "aemail.cnfg".  This is only the default name and location for
  6594. this file.  With the use of the CONFIG= Tool Type or the config= parameter
  6595. on the shell call for AEMail, you can rename the file and place it
  6596. anywhere you want.
  6597.  
  6598. Starting with AEMail version 1.13 you can also have multiple configuration
  6599. files.  This allows you to set up multiple configurations for different
  6600. users of AEMail.  You can select which configuration you want through the
  6601. "Project/Configuration/Open" menu item.
  6602.  
  6603. If the configuration is never changed with the Configuration Screen, the
  6604. Tool Type entries will take precedence.  If either the [SAVE] or [SAVE TO]
  6605. gadgets in the Configuration Screen is selected, or the
  6606. "Project/Configuration/Save" or "Project/Configuration/Save to" menu items
  6607. are selected, the General Configuration File will always take precedence.
  6608.  
  6609. The s:aemail.cnfg (or CONFIG= Tool Type or config= shell parameter) is
  6610. referred as your base configuration file.  You can always return to the
  6611. base configuration through the "Project/Configuration/Restore Default"
  6612. menu item.
  6613.  
  6614. If you display the AEMail General Configuration file with a text editor,
  6615. you will find that not all portions of the file are readable as text.  The
  6616. only way you can create and update the general configuration file is
  6617. through AEMail itself.
  6618.  
  6619. As part of this file is your password stored in encrypted format.
  6620.  
  6621.  
  6622.                                  .headers
  6623.                                  --------
  6624.  
  6625. The .headers file provides a list of message headers.  Those that you want
  6626. displayed in the message as "minimum headers" are preceded by an asterick
  6627. (*); all other headers are preceded by a space.
  6628.  
  6629. The .headers file may not be present.  If it is not, the following are
  6630. displayed as the "minimum headers":
  6631.  
  6632.     Date:
  6633.     From:
  6634.     Reply-To:
  6635.     To:
  6636.     cc:
  6637.     bcc:
  6638.     Subject:
  6639.  
  6640. See the discussion on configuring minimum headers in the General
  6641. Parameters page of the Configuration Screen.
  6642.  
  6643.  
  6644.                               folder.config
  6645.                               -------------
  6646.  
  6647. This file gives the general information about each of the folders
  6648. including:
  6649.  
  6650.     Flags (long word, 4 bytes): general flags concerning this folder
  6651.     Name (9 bytes including ending NULL): short folder name
  6652.     Pen (1 byte): pen number for folder tab
  6653.     Sort Keys (8 bytes): the permanent sort keys for the folder
  6654.     Folder Description (string ending in LINE FEED): the folder
  6655.         description.  If this is a folder for one of the pre-set
  6656.         folders, this string will be empty (LINE FEED only) unless
  6657.         the user has decided to change the folder description.
  6658.     Each Filter string ending in a LINE FEED.  Each string begins with 4
  6659.         bytes that provide filter parameters as follows:
  6660.             1 byte indicating the header to be searched
  6661.             2 bytes of flags
  6662.             1 byte indicating the compare criteria
  6663.     Three successive LINE FEEDS ends each folder config entry.
  6664.  
  6665. For those fields that are strings:  if the field is empty there will be a
  6666. LINE FEED with no data preceding it.  If filters have been specified, each
  6667. filter will have at least 4 bytes followed by the search arguement (if
  6668. present) and a LINE FEED.
  6669.  
  6670. folder.config files for versions prior to 1.40 can be read by AEMail
  6671. version 1.40 or later.  However, once a filter has been added, earlier
  6672. versions can not properly read the version 1.40 or later folder.config.
  6673. If no filters are added, earlier versions of AEMail can still read the
  6674. folder.config file.
  6675.  
  6676. It is suggested that you copy your current folder.config file to
  6677. folder.config.old before implementing AEMail 1.40.  The Install script
  6678. will do this for you with a prompt.
  6679.  
  6680. NOTE:  if for some reason your folder.config file becomes corrupted or is
  6681. accidently deleted, you can restore all of the folders and the messages
  6682. within them by doing the following:
  6683.  
  6684.     delete any current folder.config file (or rename it so it is
  6685.         no longer recognized).
  6686.     Run AEMail.  Add any additional folders that you previously
  6687.         had added.  (INBOX, PENDING, QUEUED and SENT will automatically
  6688.         be created).  You must use the exact name you had previously
  6689.         used.
  6690.     The new folders will show 0 messages.
  6691.     Quit AEMail.
  6692.     Re-Run AEMail.  The new folders should now show the appropriate
  6693.         number of messages provided a valid [folder_Name].config
  6694.         file was present for that folder.  The name of the new
  6695.         folder must exactly match the [folder_Name] in the
  6696.         [folder_Name].config file.
  6697.  
  6698.  
  6699.                            [folder_Name].config
  6700.                            --------------------
  6701.  
  6702. For each of the folders that contain messages there will be a
  6703. configuration file which gives information on the messages in that folder.
  6704. The name of the file will be the short folder name with ".config" appended
  6705. to it.
  6706.  
  6707. For this version of AEMail, the [folder_Name].config file contains the
  6708. following information for each message in the folder:
  6709.  
  6710.     Message Flags (word, 2 bytes): Flags describing the message.
  6711.     File Code (long word, 4 bytes): this field is a binary field
  6712.         which is used to derive the file name for the message file
  6713.         itself.
  6714.     Message Size (long word, 4 bytes): size of message.
  6715.     Body Displacement (word, 2 bytes): the position where the
  6716.         body of the message starts.
  6717.     From (string ending in LINE FEED): the information in the
  6718.         From: field in the message header.
  6719.     Subject (string ending in LINE FEED): the information in the
  6720.         Subject: field in the message header.  The RE: and FWD:
  6721.         headings at the beginning of the Subject header are
  6722.         stripped, but indicated by flags in the Message Flags field
  6723.         so that the exact subject field can be reconstructed.
  6724.     Date (string ending in LINE FEED): the information in the
  6725.         Date: field in the message header.
  6726.     To (string ending in LINE FEED): the information in the
  6727.         To: field in the message header.
  6728.     Reply-To (string ending in LINE FEED): the information in the
  6729.         Reply-To: field in the message header.
  6730.     cc (string ending in LINE FEED): the information in the
  6731.         cc: field in the message header.
  6732.     bcc (string ending in LINE FEED): the information in the
  6733.         bcc: field in the message header.
  6734.  
  6735. For those fields that are strings:  if the field is empty, there will be a
  6736. LINE FEED without any data preceding it.
  6737.  
  6738. NOTE:  For AEMail versions prior to 1.42, only the first header line of
  6739. any particular header type (ie, To:, cc:, etc.) was saved in the header
  6740. strings of the [Folder_Name].config file.  For version 1.42 and later, the
  6741. complete header string is saved with all lines of the particular header
  6742. type.  Up to 4096 characters can be saved (if there are that many lines
  6743. for a particular header type).
  6744.  
  6745. This is particularly important for messages that have multiple To: or cc:
  6746. recipients.  This means that the complete list of recipients can be
  6747. examined in Filter commands and also provides the capability to send
  6748. replys to all the recipients of a message.
  6749.  
  6750. This does create a problem, however, if the [Folder_Name].config created
  6751. by Version 1.42 or later is read by a version of AEMail prior to 1.42.
  6752. The Version 1.42 or later [Folder_Name].config file that contains any
  6753. message that has long multiple recipient lists (more than one line) can
  6754. not be read correctly by versions prior to 1.42.  If you need to revert to
  6755. an earlier version of AEMail, you can do the following:
  6756.  
  6757. With Version 1.42 or later, export (save) all messages with multiple
  6758. recipients that were read by 1.42 or later to a file.  You do not have to
  6759. worry about messages read by earlier versions.
  6760.  
  6761. Delete all of the messages you just saved.
  6762.  
  6763. Then, from the earlier version of AEMail, retrieve from file the messages
  6764. you just saved.  The header lines will be truncated by the earlier
  6765. version.
  6766.  
  6767. The reverse is also possible.  Messages with multiple recipients read by
  6768. earlier versions will have their header data truncated.  You can export
  6769. (save) the message to a file and then re-read it into AEMail with all
  6770. header data intact.
  6771.  
  6772.  
  6773.                                 .addrbook
  6774.                                 ---------
  6775.  
  6776. This file provides address book information.  Each record looks like this:
  6777.  
  6778.     Version (word, 2 bytes): The address book version.  Prior to
  6779.         Version 1 of the address book, this and the following field
  6780.         did not exist.  The flag $8000 identifies this as a
  6781.         legitimate version field to distinguish the addess book
  6782.         file from version 0.  NOTE: The Address Book version is
  6783.         NOT the same as the AEMail Version.  The Address Book
  6784.         version only changes when the format of the Address Book
  6785.         changes.
  6786.     Flags (word, 2 bytes): Flags describing group actions.  In
  6787.         Version 0, the flags field was given in the high order byte
  6788.         of the count field which limited the group count to 255.
  6789.     Count (word, 2 bytes): If this field is zero, the entry is
  6790.         a single user entry.  If this field is greater that zero
  6791.         it represents a group entry and indicates the number of
  6792.         UserIds in the group.
  6793.     Nickname (string ending in LINE FEED): the Nickname for this
  6794.         entry (both group or user).
  6795.     Real Name (string ending in LINE FEED): the Real Name for
  6796.         individual users or the group description for group
  6797.         entries.
  6798.     UserID (one or more strings ending in LINE FEEDS):  The number
  6799.         of UserID fields is determined by the count at the
  6800.         beginning of the record.  For individual users, this MUST
  6801.         be the UserID and Domain for that user.  For group users
  6802.         this can be a Nickname that points to the real user.
  6803.  
  6804. For a description of how entries in the Address Book can be created and
  6805. displayed see the Section VIII, AEMAIL Windows:  Address Book window.
  6806.  
  6807.  
  6808.                                 .signature
  6809.                                 ----------
  6810.  
  6811. This is a flat ASCII file that contains the signature block that is to be
  6812. appended to any composed messages.  Each line of the signature block must
  6813. end in a LINE FEED.
  6814.  
  6815. A facility is provided when composing messages to create and or edit this
  6816. signature block (see the Compose Message window description in Section
  6817. VIII above).
  6818.  
  6819. Starting with AEMail Version 1.20, multiple signature files can be used.
  6820. These signature files can be named whatever the user wishes and can be
  6821. placed wherever the user wishes (Registered Users ONLY).
  6822.  
  6823.                                  Messages
  6824.                                  --------
  6825.  
  6826. Each message is stored as an individual file with a cryptic file name
  6827. generated from the File Code in the [Folder_Name].config file.  This name
  6828. begins with "AE" and ends with "M" with a number of numeric digits in
  6829. between.  The message is stored as a flat ASCII file as it is received
  6830. from the POP Server with any CARRAGE RETURNS in a CARRAGE RETURN/LINE FEED
  6831. sequences stripped.  This follows the Amiga format for ASCII files.
  6832.  
  6833. The complete message is stored along with any attachments as they were
  6834. orginally received.  Any particular message can be copied to a named file
  6835. anywhere in your system through the "SAVE MESSAGE TO FILE" command.  If
  6836. you have an off line program that can process a mime message or a message
  6837. with UUENCODED attachments, you can use that program against this file to
  6838. extract the attachments or you can save that attachment directly with the
  6839. Attachment Requester in the Message Display Window (Section VIII).
  6840.  
  6841. If messages are left in the PENDING or QUEUED folders, two additional
  6842. files may be created when AEMail terminates.  If attachments were added to
  6843. the message when it was created, a file with the same name as the message
  6844. file but with "AT" appended to it will be created.  This file contains
  6845. information about the attachments.  A second file may be created if
  6846. additional headers were created.  This file has "HD" appended to the
  6847. original message name.
  6848.  
  6849. Both of these files are deleted when AEMail is loaded and the PENDING and
  6850. QUEUED message lists are created internally.  The files are re-created if
  6851. the messages remain in the PENDING or QUEUED folders when AEMail
  6852. terminates.
  6853.  
  6854. PLEASE NOTE:  if the [folder_Name].config file is deleted you will lose
  6855. all capability of retrieving your messages unless you have previously
  6856. copied them to named files.
  6857.  
  6858.  
  6859.                        TCP Trace Log File (TCPLOG)
  6860.                        ---------------------------
  6861.  
  6862. This file is present if you have specified
  6863.  
  6864.     TCPLOG=name-of-log-file
  6865.  
  6866. in the Tool Types parameters or named a "TCP Logging File" in the Default
  6867. Path Parameters page of the Configuration screen.  Since
  6868. "name-of-log-file" must be the full path name of the log file, this file
  6869. may or may not reside in the AEMAIL:  directory
  6870.  
  6871. The TCP Trace Log File traces every TCP transaction.  Each time AEMail is
  6872. started the following record is written to the file:
  6873.  
  6874.     Logging Beginning at DD MMM YR HH:MM:SS
  6875.  
  6876. where DD is the day of the week, MMM is the month (Jan, Feb, Mar, etc), YY
  6877. is the 2 digit year (97) and HH, MM, and SS are the hour (24 hour clock),
  6878. minutes, and seconds.
  6879.  
  6880. Each logging record will consist of a 38 byte header and up to 82 bytes of
  6881. either descriptive information or actual data received or sent over the
  6882. TCP interface.  The header consists of a 21 byte date/time stamp (DD MMM
  6883. YR HH:MM:SS) and 16 byte routine name of the routine in AEMail that called
  6884. the trace.
  6885.  
  6886. If data is displayed, instances of a CARRAGE RETURN will be displayed as
  6887. <CR> and of LINE FEEDS as <LF>.  If the data exceeds 82 bytes, <---> will
  6888. be placed at the end of the line.
  6889.  
  6890. When AEMail terminates, or the TCPLOG file name is changed by the Default
  6891. Path Parameters page of the Configuration screen, the following record is
  6892. written to the file:
  6893.  
  6894.     Logging Ending at DD MMM YY HH:MM:SS
  6895.  
  6896. Each AEMail session is stacked behind the previous one, so that the file
  6897. can become quite large.  Periodic purging of the file can occur by
  6898. deleting the TCPLOG file in between sessions of AEMail.  Also, a new file
  6899. is created when you change the name of the TCPLOG file with the
  6900. Configuration screen.
  6901.  
  6902.  
  6903.                       X. BUG REPORTS AND SUGGESTIONS
  6904.  
  6905. Bugs should be reported to:
  6906.  
  6907.     jzachar@calweb.com
  6908.  
  6909. by email.  You can also use the nickname AEMAIL which has been
  6910. automatically stored in your address book.
  6911.  
  6912. In reporting bugs, be as complete as possible in describing the
  6913. circumstances leading up to the bug.  It would be helpful if you indicate
  6914. all actions (mouse clicks, etc) that you took before the problem occurred.
  6915. If you are having problems connecting to your Internet provider, or
  6916. sending or receiving mail, you should activate the TCP Log file (See
  6917. Section IX, AEMAIL FILES:  TCP Trace Log File) and send a copy of the log
  6918. as an attachment to your message.  You might want to block out any
  6919. password that is contained in the file before you send it to me, however.
  6920. You can do that with any text editor.
  6921.  
  6922. I would also appreciate any suggestions that you have for improving
  6923. AEMail.  I will not guarantee that I will accept all suggestions or that I
  6924. will necessarily implement them in the next release; however, I do take
  6925. each suggestion seriously.  In the past I have implemented a number of
  6926. suggestions made by my testers.  I will attempt to respond to each
  6927. suggestion that is made.
  6928.  
  6929. In making suggestions keep in mind some of the restraints that I have
  6930. placed on AEMAIL:
  6931.  
  6932.     (1) The program should be able to be run on any version of
  6933.         AmigaDos 2.1 or greater, and
  6934.  
  6935.     (2) with the exception of TCP/IP stack software (ie., AmiTCP, Miami,
  6936.         or TermiteTCP) AEMail should not require any extension to your
  6937.         system that does not come with a standard AmigaDOS release.  This
  6938.         effectively rules out MUI.  Using an editor of your choice meets
  6939.         this criteria since you can use the standard AmigaDOS editors, ED
  6940.         or MEMACS, which come with the standard AMIGA systems.
  6941.  
  6942. When reporting bugs or making suggestions, please be as complete as
  6943. possible in describing the circumstances that brought about the problem or
  6944. how the suggestion could be implemented.
  6945.  
  6946.  
  6947.                               XI. REFERENCES
  6948.  
  6949. A number of software packages are mentioned in this documentation.
  6950. Details on how to obtain these packages are given below:
  6951.  
  6952.     TCP/IP STACKS
  6953.  
  6954.         AmiTCP      A TCP/IP stack for use with the Amiga.  AmiTCP
  6955.                     is copyright (c) 1994, 1995 by Network Solutions
  6956.                     Development, Inc.
  6957.  
  6958.                     AmiTCP was developed by Network Solutions Development,
  6959.                     Inc., P.O.  Box 32, FIN-02151 Espoo, Finland.
  6960.  
  6961.                     A demo 4.0 version is available on AmiNet sites in
  6962.                     countries other than USA or Australia.  It can also
  6963.                     be found on many BBS's.
  6964.  
  6965.                     The commercial version is distributed by Village
  6966.                     Tronic Marketing GmbH, Wellweg 95, D-31157 Sarstedt,
  6967.                     Germany, and is available from many Amiga dealers and
  6968.                     mail order houses.
  6969.  
  6970.                     World Wide Web home page for Network Solutions
  6971.                     Development, Inc is:
  6972.  
  6973.                         http://www.xgu.fi/biz/NSDI/
  6974.  
  6975.                     email addresses: info@nsdi.fi
  6976.                                      AmiTCP-Support@nsdi.fi
  6977.                                      AmiTCP-Group@nsdi.fi
  6978.  
  6979.         Miami       A TCP/IP stack compatible with AmiTCP.  This stack
  6980.                     is very simple to install and configure.  Miami is
  6981.                     copyright (c) 1996, 1997 by Holger Kruse.  It is
  6982.                     currently shareware and is available at
  6983.  
  6984.                         http://www.nordicglobal.com/miami.html
  6985.  
  6986.                     on the WWW or it may be available on local BBS's.
  6987.                     Some versions are available on AmiNet, but if you want
  6988.                     the latest version consult the web page listed above.
  6989.  
  6990.                     email addresses: kruse@nordicglobal.com
  6991.                                      kruse@america.com
  6992.  
  6993.                     If you are using Miami, the "Down when Offline" item
  6994.                     in the TCP/IP Settings page for Miami should be
  6995.                     checked and your settings saved.  This will prevent
  6996.                     Miami from waiting 80 seconds before returning a
  6997.                     failure when you try to access the Internet when you
  6998.                     are "Offline".
  6999.  
  7000.         TermiteTCP  A TCP/IP stack compatible with AmiTCP.  This stack is
  7001.                     very simple to install and configure.  TermiteTCP is
  7002.                     copyright (c) 1996 by Oregon Research, 16200 S.W.
  7003.                     Pacific Hwy, Suite 162, Tigard, OR 97224.
  7004.  
  7005.                     This is a commercial product available at many Amiga
  7006.                     dealers, mail order houses, or directly from Oregon
  7007.                     Research.
  7008.  
  7009.                     World Wide Web home page for Oregon Research is:
  7010.  
  7011.                         http://www.orres.com/~orres/
  7012.  
  7013.                     email address: support@orres.com
  7014.  
  7015.  
  7016.     WWW BROWSERS
  7017.  
  7018.         IBrowse     Copyright (c) 1995, 1996 by Omnipresence Intl.
  7019.  
  7020.                     IBrowse is a commercial product distributed by Oregon
  7021.                     Research in the United States and HiSoft in the
  7022.                     United Kingdom and can be obtained from Amiga dealers
  7023.                     or mail order houses.  A demo version and upgrades can
  7024.                     be obtained from the Omnipresence WWW site at:
  7025.  
  7026.                         http://www.omnipresence.com/ibrowse
  7027.  
  7028.                     and on AmiNet.
  7029.  
  7030.         Voyager NG  Copyright (c) 1995-97 by Oiver Wagner.  Voyager is
  7031.                     available for download from AmiNet or the
  7032.  
  7033.                         http://www.vapor.com/support
  7034.  
  7035.                     WWW site.
  7036.  
  7037.                     email address: owagner@lsd.wupper.de
  7038.  
  7039.         AWeb-II     Copyright (c) 1996 by AmiTrix Development.
  7040.  
  7041.                     Both a public domain demo (AWEB) and a commercial
  7042.                     (AWEB II) version is available.  The public domain
  7043.                     demo version can be found on AmiNet (AWeb v1.2b),
  7044.                     many BBS's, or on the AmiTrix WWW site:
  7045.  
  7046.                         http://www.networkx.com/amitrix/aweb.html
  7047.  
  7048.                     The commercial version (AWEB II) can be obtained from
  7049.                     Amiga dealers or mail order houses.
  7050.  
  7051.                     email addresses: sales@amitrix.com
  7052.                                      support@amitrix.com
  7053.  
  7054.                     Mailing address: AmiTrix Development
  7055.                                      5312-47 Street
  7056.                                      Beaumont Alberta, Canada T4X 1H9
  7057.  
  7058.  
  7059.                             XII. IN CONCLUSION
  7060.  
  7061. As payment for receiving and using this unregestered BETA version of
  7062. AEMail, I would like any bugs, comments, or suggestions reported to me.
  7063. You can send me email at
  7064.  
  7065.     jzachar@calweb.com
  7066.  
  7067. or use the AEMAIL Nickname created in your Address Book.
  7068.  
  7069. You can also register AEMail for a shareware fee of $30.  See the
  7070. discussion on REGISTRATION under Section II.  SYSTEM REQUIREMENTS.
  7071.  
  7072. See the Section X, Bug Reports and Suggestions above for the reporting
  7073. procedure.
  7074.  
  7075. If you give a unregistered version of this program to anyone else to use
  7076. and evaluate, please include the complete archive as distributed.  This
  7077. includes the AEMail program, the installation script, and all
  7078. documentation and readme files.
  7079.  
  7080. The complete archive is being posted on AmiNet and may be posted to any
  7081. BBS.  If it is posted to any particular BBS, I would appreciate it if the
  7082. SYSOP of that BBS would send me an email message indicating the BBS it was
  7083. posted to.
  7084.  
  7085. Future versions of AEMail are planned that will implement the following
  7086. features:
  7087.  
  7088.         AREXX Support
  7089.         Filtering incoming messages to specified folders
  7090.         Asynchronous retrieval of messages from a POP server
  7091.         Asynchronous sending of messages to the SMTP server
  7092.         Even faster message display routines with several added features
  7093.             including saving portions of the message to the clipboard
  7094.             and transferring embedded email addresses to the address
  7095.             book.
  7096.         Built in message editor
  7097.         Other features suggested by users
  7098.  
  7099. I have a web site at:
  7100.  
  7101.     http://www.calweb.com/~jzachar/
  7102.  
  7103. The latest version of AEMail will be posted to this web site.  Major
  7104. releases will also be posted on AmiNet.
  7105.  
  7106. Whenever a new version of AEMail is available, I will email all users for
  7107. which I have received notification messages (see Registration in Section
  7108. II) with notice of the new version.  If you do not wish to receive this
  7109. notification, please email me at jzachar@calweb.com.
  7110.  
  7111. Thanks,
  7112.  
  7113. John Zacharias
  7114. jzachar@calweb.com
  7115.  
  7116. www: http://www.calweb.com/~jzachar/
  7117.  
  7118.  
  7119.